Add

Add a new Organization.

Request Format

Method

POST

URL

/organizations.<format>

Request Body

Organization Request

Response Format

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of Organization

Organization created

400 Bad Request


Organization 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

500 Other Error


Unknown error


Delete

Remove an Organization.

Request Format

Method

DELETE

URL

/organizations/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 Deleted


Organization deleted

400 Invalid Fields


id not provided

401 Unauthorized


Authentication required

404 Organization Unknown


id not found

500 Other Error


Unknown error


Edit

Edit an existing Organization.

Request Format

Method

PUT

URL

/organizations/<id>.<format>

Request Body

Organization Request

Response Format

HTTP Status

Response Body

Description

200 OK


Organization updated

400 Bad Request


Organization 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

404 Organization Unknown


id not found

500 Other Error


Unknown error


View (all)

Retrieve all existing Organizations.

Request Format

Method

GET

URL

/organizations.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

Organization Response

Organizations returned

401 Unauthorized


Authentication required

500 Other Error


Unknown error


View (per CO)

Retrieve Organizations attached to a CO.

Request Format

Method

GET

URL

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

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

Organization Response

Organization returned

401 Unauthorized


Authentication required

404 CO Unknown


id not found

500 Other Error


Unknown error


View (one)

Retrieve an existing Organization.

Request Format

Method

GET

URL

/organizations/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

Organization Response

Organization returned

401 Unauthorized


Authentication required

404 Organization 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