Confirm

Confirm a CoInvite.

Request Format

Method

DELETE

URL

/co_invites.<format>?inviteid=<id>&reply=confirm

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 Deleted

 

CoInvite confirmed and deleted

400 CoPerson Unknown

 

CoInvite points to an unknown CoPerson

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized

 

Authentication required

403 Expired

 

The CoInvite expired and is no longer valid

404 CoInvite Unknown

 

id not found

500 Other Error

 

Unknown error


Decline

Decline a CoInvite.

Request Format

Method

DELETE

URL

/co_invites.<format>?inviteid=<id>&reply=decline

Request Body

 

Response Format

HTTP Status

Response Body

Description

200 Deleted

 

CoInvite declined and deleted

400 CoPerson Unknown

 

CoInvite points to an unknown CoPerson

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

401 Unauthorized

 

Authentication required

403 Expired

 

The CoInvite expired and is no longer valid

404 CoInvite Unknown

 

id not found

500 Other Error

 

Unknown error


Send

Send a CoInvite for a CO to an Org Identity.

Request Format

Method

POST

URL

/co_invites.<format>

Request Body

CoInvite Request

Response Format

HTTP Status

Response Body

Description

201 Sent

NewObjectResponse with ObjectType of CoInvite

CoInvite created and sent. Note that the ID returned is the row record ID and not the one time password sent to the invitee.

400 Bad Request

 

CoInvite Request not provided in POST body

400 Invalid Fields

ErrorResponse with details in InvalidFields element

An error in one or more provided fields

400 No Email Address

 

The Org Identity has no known email addresses and so no invite can be sent

401 Unauthorized

 

Authentication required

500 Other Error

 

Unknown error

503 Not Sent

 

The invite was unable to be sent


Notes

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

See Also

  • No labels