Add

Add a new CO Department.

Request Format

Method

POST

URL

/co_departments.<format>

Request Body

CoDepartment Request

Response Format

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of CoDepartment

CoDepartment created

400 Bad Request

 

CoDepartment 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 CO Does Not Exist

 

The specified CO does not exist

500 Other Error

 

Unknown error


Delete

Remove a CO Department. This method will also delete related data, such as EmailAddresses and Identifiers.

Request Format

Method

DELETE

URL

/co_departments/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 Deleted

 

CoDepartment deleted

400 Invalid Fields

 

id not provided

401 Unauthorized

 

Authentication required

404 CoDepartment Unknown

 

id not found

500 Other Error

 

Unknown error


Edit

Edit an existing CO Department.

Request Format

Method

PUT

URL

/co_departments/<id>.<format>

Request Body

CoDepartment Request 

Response Format

HTTP Status

Response Body

Description

200 OK

 

CoDepartment updated

400 Bad Request

 

CoDepartment 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 CO Does Not Exist

 

The specified CO does not exist

404 CoDepartment Unknown

 

id not found

500 Other Error

 

Unknown error


View (all)

Retrieve all existing CO Departments.

Request Format

Method

GET

URL

/co_departments.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoDepartment Response 

CoDepartment returned

401 Unauthorized

 

Authentication required

500 Other Error

 

Unknown error


View (per CO)

Retrieve all existing CO Departments for the specified CO.

Request Format

Method

GET

URL

/co_departments.<format>?coid=<id>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoDepartment Response 

CoDepartment returned

401 Unauthorized

 

Authentication required

404 CO Unknown

 

id not found

500 Other Error

 

Unknown error


View (per Identifier)

Retrieve all existing CO Departments attached to the specified identifier.

Request Format

Method

GET

URL

/co_departments.<format>?coid=<id>&search.identifier=<identifier>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoDepartment Response 

CoDepartment returned

401 Unauthorized

 

Authentication required

404 CO Unknown

 

id not found

500 Other Error

 

Unknown error


View (one)

Retrieve an existing CO Department.

Request Format

Method

GET

URL

/co_departments/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoDepartment Response

CoDepartment returned

401 Unauthorized

 

Authentication required

404 CoPerson 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.

See Also

  • No labels