Users
extends BaseEndpoint
in package
Routing class for the subnamespace `Users`
Tags
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
$audit
public
Audit
$audit
$bbidstatus
public
Bbidstatus
$bbidstatus
$changed
public
Changed
$changed
$education
public
Education
$education
$employment
public
Employment
$employment
$enroll
public
Enroll
$enroll
$enrollments
public
Enrollments
$enrollments
$extended
public
Extended
$extended
$gendertypes
public
Gendertypes
$gendertypes
$me
public
Me
$me
$occupations
public
Occupations
$occupations
$phones
public
Phones
$phones
Routing
class for the subnamespace Phones
$phonetypes
public
Phonetypes
$phonetypes
$students
public
Students
$students
$_addresses
protected
Addresses|null
$_addresses
= null
Routing class for the subnamespace Addresses
$_addresstypes
protected
Addresstypes|null
$_addresstypes
= null
$_addresstypes
$_audit
protected
Audit|null
$_audit
= null
$_bbidstatus
protected
Bbidstatus|null
$_bbidstatus
= null
$_changed
protected
Changed|null
$_changed
= null
$_customfields
protected
Customfields|null
$_customfields
= null
$_customfields Routing class for the subnamespace Customfields
$_education
protected
Education|null
$_education
= null
$_emergencycontacts
protected
Emergencycontacts|null
$_emergencycontacts
= null
$_emergencycontacts Routing class for the subnamespace
Emergencycontacts
$_employment
protected
Employment|null
$_employment
= null
$_enroll
protected
Enroll|null
$_enroll
= null
$_enrollments
protected
Enrollments|null
$_enrollments
= null
$_enrollments
$_extended
protected
Extended|null
$_extended
= null
$_gendertypes
protected
Gendertypes|null
$_gendertypes
= null
$_gendertypes
$_me
protected
Me|null
$_me
= null
$_occupations
protected
Occupations|null
$_occupations
= null
$_occupations
$_phones
protected
Phones|null
$_phones
= null
Routing
class for the subnamespace Phones
$_phonetypes
protected
Phonetypes|null
$_phonetypes
= null
$_relationships
protected
Relationships|null
$_relationships
= null
$_relationships
$_students
protected
Students|null
$_students
= null
$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
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
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
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
Return values
int —ID of the user just created.