Add
Add a new CO Person. A person must have an OrgIdentity before they can be added to a CO. Note that linking to an OrgIdentity and invitations are separate operations.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| NewObjectResponse with | CoPerson created |
| CoPerson Request not provided in POST body | |
| ErrorResponse with details in | An error in one or more provided fields |
| Authentication required | |
| The specified CO does not exist | |
| Unknown error |
Delete
Remove a CO Person. This method will also delete related data, such as CoPersonRoles, EmailAddresses, and Identifiers. A person must be removed from any COs (CoPerson records must be deleted) before the OrgIdentity record can be removed.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPerson deleted | |
|
| |
| Authentication required | |
| The Person has one or more Person Role records and cannot be deleted | |
| The Person has a role in one or more COUs that the authenticated user does not control | |
|
| |
| Unknown error |
Edit
Edit an existing CO Person.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPerson updated | |
| CoPerson Request not provided in POST body | |
| ErrorResponse with details in | An error in one or more provided fields |
| Authentication required | |
| The specified CO does not exist | |
|
| |
| Unknown error |
Find
Search for existing CO Person records.
When too many records are found, a message may be returned rather than specific records.
Provisional API
This API call is currently intended only to support the People Picker user interface element. It does not currently support RESTful response codes. It may change across minor releases. It may be eventually be merged with the Match API.
The Find API is available as of Registry v3.3.0.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
where
- id: CO ID
- mode: Search context, currently the supported values are S (Sponsor Mode), AL (All Mode) and M (Manager Mode)
- string: Search string, which may be a partial or full name token, or a complete Email Address or Identifier
Response Format
A JSON array of objects, where each object contains a label
(human readable string) and value
(CO Person ID).
Match
Attempt to match existing CO Person records.
Note that matching is not performed on search criteria of less than 3 characters, or for email addresses that are not syntactically valid.
Provisional API
This API call is likely to evolve to accept search criteria more flexibly. It may change across minor releases. It may eventually be removed in favor of the Find API.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
mail
was added in Registry v3.3.0.
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPerson returned (zero or more matches may be returned) | |
| Authentication required | |
|
| |
| Unknown error |
View (all)
Retrieve all existing CO People.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPerson returned | |
| Authentication required | |
| Unknown error |
View (per CO)
Retrieve all existing CO People for the specified CO.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPeople returned | |
| Authentication required | |
|
| |
| Unknown error |
View (per Email Address)
Retrieve all existing CO People attached to the specified Email Address. Note the specified identifier must be attached to a CO Person, not an Org Identity. Available as of Registry v4.1.0.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPeople returned | |
| Authentication required | |
|
| |
| Unknown error |
View (per Identifier)
Retrieve all existing CO People attached to the specified identifier. Note the specified identifier must be attached to a CO Person, not an Org Identity.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPeople returned | |
| Authentication required | |
|
| |
| Unknown error |
View (one)
Retrieve an existing CO Person.
Request Format
Method |
|
---|---|
URL |
|
Request Body |
Response Format
HTTP Status | Response Body | Description |
---|---|---|
| CoPerson returned | |
| Authentication required | |
|
| |
| Unknown error |
Notes
- Response format requested is ignored where response is only via HTTP status, but must still be provided.
See Also
- cm_org_identities data model definition
- CoOrgIdentityLink API
- CoPersonRole API
- EmailAddress API (required for Invites)
- Identifier API
- OrgIdentity API
- TelephoneNumber API
- Url API