Versions Compared

Key

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

...

Add a new CoProvisioningTarget.

Request Format

Method

POST

URL

/co_provisioning_targets.<format>

Request Body

CoProvisioningTarget Request

Response Format

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of CoProvisioningTarget

CoProvisioningTarget added

400 Bad Request

 

CoProvisioningTarget 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 CoProvisioningTarget.

Request Format

Method

DELETE

URL

/co_provisioning_targets/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 Deleted

 

CoProvisioningTarget deleted

400 Invalid Fields

 

id not provided

401 Unauthorized

 

Authentication required

404 CoProvisioningTarget Not Found

 

id not found

500 Other Error

 

Unknown error

...

Edit

Edit an existing CoProvisioningTarget.

Request Format

Method

PUT

URL

/co_provisioning_targets/<id>.<format>

Request Body

CoProvisioningTarget Request

Response Format

HTTP Status

Response Body

Description

200 OK

 

CoProvisioningTarget updated

400 Bad Request

 

CoProvisioningTarget 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 CoProvisioningTarget Unknown

 

id not found

500 Other Error

 

Unknown error

...

Provision

Request provisioning (or reprovisioning) of a CO Person.

Note
titleProvisional API

This API call is likely to evolve to offer more flexibility. It may change across minor releases.

Request Format

Method

POST

URL

/co_provisioning_targets/provision/id/copersonid:copersonid

.<format>

/co_provisioning_targets/provision/id/cogroupid:cogroupid

.<format>

/co_provisioning_targets/provision/id/coemaillistid:coemaillistid

Request Body

CoPerson Provisioning Request, CoGroup Provisioning Request, or

CoGroup

CoEmailList Provisioning Request

Response Format

HTTP Status

Response Body

Description

200 OK

 

Provisioning request has been successfully processed

202 Accepted

 

Provisioning request has been queued
(warning) Not currently implemented

401 Unauthorized

 

Authentication required

404 CoPerson Unknown

 

CO Person not found

404 CoGroup Unknown

 

CO Group not found

404 CoEmailList Unknown

 

CO Email List not found

404 CoProvisioningTarget Not Found

 

id not found

500 Other Error

 

Unknown error

...

View (all)

Retrieve all existing CoProvisioningTarget.

Request Format

Method

GET

URL

/co_provisioning_targets.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoProvisioningTarget Response

CoProvisioningTarget returned

401 Unauthorized

 

Authentication required

500 Other Error

 

Unknown error

...

View (per CO)

Retrieve CoProvisioningTargets attached to a CO.

Request Format

Method

GET

URL

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

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoProvisioningTarget Response

CoProvisioningTargets returned

401 Unauthorized

 

Authentication required

404 CO Unknown

 

id not found

500 Other Error

 

Unknown error

...

View (one)

Retrieve an existing CoProvisioningTarget.

Request Format

Method

GET

URL

/co_provisioning_targets/<id>.<format>

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 OK

CoProvisioningTarget Response

CoProvisioningTarget returned

401 Unauthorized

 

Authentication required

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

...