Versions Compared

Key

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

...

HTTP Status

Response Body

Description

201 Added

NewObjectResponse with ObjectType of TelephoneNumber

TelephoneNumber added

400 Bad Request

 


TelephoneNumber 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 No Person Specified

 


A CO Department, a CO Person Role, or an Org Identity must be specified to attach the Telephone Number to

403 Person Does Not Exist

 


The specified CO Department, CO Person Role, or Org Identity does not exist

500 Other Error 


Unknown error

...

Delete

Remove a TelephoneNumber.

...

 

Method

DELETE

URL

/telephone_numbers/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 Deleted

 


Address deleted

400 Invalid Fields 


id not provided

401 Unauthorized 


Authentication required

404 TelephoneNumber Unknown 


id not found

500 Other Error 


Unknown error

...

Edit

Edit an existing TelephoneNumber.

...

HTTP Status

Response Body

Description

200 OK 


TelephoneNumber updated

400 Bad Request 


TelephoneNumber 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 No Person Specified

 


A CO Department, a CO Person Role, or an Org Identity must be specified to attach the Telephone Number to

403 Person Does Not Exist

 


The specified CO Department, CO Person Role, or Org Identity does not exist

404 TelephoneNumber Unknown

 


id not found

500 Other Error 


Unknown error

...

View (all)

Retrieve all existing TelephoneNumbers.

...

Method

GET

URL

/telephone_numbers.<format>

Request Body

 


Response Format

HTTP Status

Response Body

Description

200 OK

TelephoneNumber Response

TelephoneNumbers returned

401 Unauthorized

 


Authentication required

500 Other Error 


Unknown error

...

View (per person)

...

 

Method

GET

URL

/telephone_numbers.<format>?[codeptid|copersonroleid|organizationid|orgidentityid]=<id>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

TelephoneNumber Response

TelephoneNumber returned

204 CO Department Has No TelephoneNumber 
The requested CO Department was found, but has no telephone numbers attached

204 CO Person Role Has No TelephoneNumber

 


The requested CO Person Role was found, but has no telephone numbers attached

204 Org Identity Has No TelephoneNumber

 


The requested Org Identity was found, but has no telephone numbers attached

204 Organization Has No TelephoneNumber


The requested Organization was found, but has no telephone numbers attached

401 Unauthorized 


Authentication required

404 CO Department Unknown

 


id not found for CO Department

404 CO Person Role Unknown

 


id not found for CO Person Role

404 Organization Unknown


id not found for Organization

404 Org Identity Unknown 


id not found for Org Identity

500 Other Error 


Unknown error

...

View (one)

Retrieve an existing TelephoneNumber.

...

 

Method

GET

URL

/telephone_numbers/<id>.<format>

Request Body


Response Format

HTTP Status

Response Body

Description

200 OK

TelephoneNumber Response

TelephoneNumber returned

401 Unauthorized 


Authentication required

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

...