Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Add a new CO Person Role.

Request Format

Method

POST

URL

/co_person_roles.<format>

Request Body

CoPersonRole Request

Response Format

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of CoPersonRole

CoPersonRole created

400 Bad Request

 

CoPersonRole Request not provided in POST body

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized

 

Authentication required

403 COU Does Not Exist

 

The specified COU does not exist

500 Other Error

 

Unknown error

...

Delete

Remove a CO Person Role.

Request Format

Method

DELETE

URL

co_person_roles/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 Deleted

 

CoPersonRole deleted

400 Invalid Fields

 

id not provided

401 Unauthorized

 

Authentication required

404 CoPersonRole Unknown

 

id not found

500 Other Error

 

Unknown error

...

Edit

Edit an existing CO Person Role.

Request Format

Method

PUT

URL

/co_person_roles/<id>.<format>

Request Body

CoPersonRole Request

Response Format

HTTP Status

Response Body

Description

200 OK

 

CoPersonRole updated

400 Bad Request

 

CoPersonRole Request not provided in POST body

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized

 

Authentication required

403 COU Does Not Exist

 

The specified COU does not exist

404 CoPersonRole Unknown

 

id not found

500 Other Error

 

Unknown error

...

View (all)

Retrieve all existing CO Person Roles.

Request Format

Method

GET

URL

/co_person_roles.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoPersonRole Response

CoPersonRoles returned

401 Unauthorized

 

Authentication required

500 Other Error

 

Unknown error

...

View (per CO Person)

Retrieve all existing CO Person Roles for the specified CO Person. Available since Registry v1.1.0.

Request Format

Method

GET

URL

/co_person_roles.<format>?copersonid=<id>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoPersonRole Response

CoPersonRoles returned

401 Unauthorized

 

Authentication required

404 CO Person Unknown

 

id not found

500 Other Error

 

Unknown error

...

View (per COU)

Retrieve all existing CO Person Roles for the specified COU.

Request Format

Method

GET

URL

/co_person_roles.<format>?couid=<id>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoPersonRole Response

CoPersonRoles returned

401 Unauthorized

 

Authentication required

404 COU Unknown

 

id not found

500 Other Error

 

Unknown error

...

View (one)

Retrieve an existing CO Person Role.

Request Format

Method

GET

URL

/co_person_roles/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoPersonRole Response

CoPersonRole returned

401 Unauthorized

 

Authentication required

404 CoPersonRole Unknown

 

id not found

500 Other Error

 

Unknown error

...

Notes

  • Response format requested is ignored where response is only via HTTP status, but must still be provided.

...