Documentation

Users extends BaseEndpoint
in package

Routing class for the subnamespace `Users`

Tags
@property

\Blackbaud\SKY\School\Endpoints\V1\Users\Relationships $relationships

@property

\Blackbaud\SKY\School\Endpoints\V1\Users\Emergencycontacts $emergencycontacts Routing class for the subnamespace Emergencycontacts

@property

\Blackbaud\SKY\School\Endpoints\V1\Users\Addresstypes $addresstypes

@property

\Blackbaud\SKY\School\Endpoints\V1\Users\Customfields $customfields Routing class for the subnamespace Customfields

Table of Contents

Properties

$addresses  : Addresses
$audit  : Audit
$bbidstatus  : Bbidstatus
$changed  : Changed
$education  : Education
$employment  : Employment
$enroll  : Enroll
$enrollments  : Enrollments
$extended  : Extended
$gendertypes  : Gendertypes
$me  : Me
$occupations  : Occupations
$phones  : Phones
$phonetypes  : Phonetypes
$students  : Students
$_addresses  : Addresses|null
$_addresstypes  : Addresstypes|null
$_audit  : Audit|null
$_bbidstatus  : Bbidstatus|null
$_changed  : Changed|null
$_customfields  : Customfields|null
$_education  : Education|null
$_emergencycontacts  : Emergencycontacts|null
$_employment  : Employment|null
$_enroll  : Enroll|null
$_enrollments  : Enrollments|null
$_extended  : Extended|null
$_gendertypes  : Gendertypes|null
$_me  : Me|null
$_occupations  : Occupations|null
$_phones  : Phones|null
$_phonetypes  : Phonetypes|null
$_relationships  : Relationships|null
$_students  : Students|null
$endpoints  : array<string, BaseEndpoint>>
$url  : string

Methods

getByUserId()  : UserRead
Returns data for the specified ```user\_id```.
list_()  : UserReadCollection
Returns a paginated collection of users, limited to 100 users per page.
patch()  : int
Updates the record of a single user. **Note:** Deleting/clearing data from a field requires the use of the ```fields\_to\_delete``` property described below
post()  : int
Creates a new user record.

Properties

$addresses

public Addresses $addresses

Routing class for the subnamespace Addresses

$phones

public Phones $phones

Routing class for the subnamespace Phones

$_addresses

protected Addresses|null $_addresses = null

Routing class for the subnamespace Addresses

$_customfields

protected Customfields|null $_customfields = null

$_customfields Routing class for the subnamespace Customfields

$_emergencycontacts

protected Emergencycontacts|null $_emergencycontacts = null

$_emergencycontacts Routing class for the subnamespace Emergencycontacts

$_phones

protected Phones|null $_phones = null

Routing class for the subnamespace Phones

$endpoints

protected array<string, BaseEndpoint>> $endpoints = ["relationships" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Relationships", "phonetypes" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Phonetypes", "extended" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Extended", "changed" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Changed", "phones" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Phones", "occupations" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Occupations", "emergencycontacts" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Emergencycontacts", "addresses" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Addresses", "addresstypes" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Addresstypes", "education" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Education", "audit" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Audit", "enroll" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Enroll", "employment" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Employment", "gendertypes" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Gendertypes", "bbidstatus" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Bbidstatus", "students" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Students", "me" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Me", "customfields" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Customfields", "enrollments" => "\\Blackbaud\\SKY\\School\\Endpoints\\V1\\Users\\Enrollments"]

$endpoints Routing subpaths

$url

protected string $url = "https://api.sky.blackbaud.com/school/v1/users/{user_id}"

Methods

getByUserId()

Returns data for the specified ```user\_id```.

public getByUserId(array{user_id: int} $params) : UserRead

Requires at least one of the following roles in the Education Management system:

  • SKY API Data Sync
Parameters
$params : array{user_id: int}

An associative array

  • user_id: Format - int32. ID of the user to be returned.
Tags
throws
ArgumentException

if required parameters are not defined

Return values
UserRead

Success

list_()

Returns a paginated collection of users, limited to 100 users per page.

public list_(array<string|int, mixed> $params) : UserReadCollection

Use the record number as the marker value to return the next set of results. For example: marker=101 will return the second set of results.

Results are dependent on the directory settings of each user.

Requires at least one of the following roles in the Education Management system:

  • Billing Clerk

  • Password Manager

  • Contact Card Manager

  • Platform Manager

Parameters
$params : array<string|int, mixed>
Tags
throws
ArgumentException

if required parameters are not defined

Return values
UserReadCollection

Success

patch()

Updates the record of a single user. **Note:** Deleting/clearing data from a field requires the use of the ```fields\_to\_delete``` property described below

public patch(UserEdit $requestBody) : int

Returns the ID of the user just updated upon success.

Requires at least one of the following roles in the Education Management system:

  • Platform Manager

  • Contact Card Manager

Parameters
$requestBody : UserEdit

User information to be updated

Tags
throws
ArgumentException

if required parameters are not defined

Return values
int

ID of the user just updated.

post()

Creates a new user record.

public post(UserAdd $requestBody) : int

Returns the newly created ID.

Requires at least one of the following roles in the Education Management system:

  • Platform Manager

  • Contact Card Manager

Parameters
$requestBody : UserAdd

The user to be created

Tags
throws
ArgumentException

if required parameters are not defined

Return values
int

ID of the user just created.


        
On this page

Search results