DELETE user/…/catalog

DELETE Revokes catalog permission for a user.

Resource URL

https://www.drillster.com/api/2/user/{user_id}/catalog/{catalog_id}

or

https://www.drillster.com/api/2/user/{email_address}/catalog/{catalog_id}

or

https://www.drillster.com/api/2/user/{third_party_id}/catalog/{catalog_id}

Parameters

Field Type Description
user_id
one of user_id, email_address or third_party_id required
String

The user ID to revoke catalog access for.

Example value: nPjYUn0upc8dIm7yzTIBgQ

email_address
one of user_id, email_address or third_party_id required
String

The email address for the user to revoke catalog access for.

Note that the email address is part of the URI and therefore needs to be URL encoded!

Example value: jane@example.com

third_party_id
one of user_id, email_address or third_party_id required
String

A third party ID for the user to revoke catalog access for, formatted as THIRD_PARTY/ID.

Note that the third party ID is part of the URI and therefore needs to be URL encoded!

Example value: COMPANY/12345

catalog_id
required
String

The unique key of the catalog to revoke user access for.

Example value: 8dImzTInPjYUn0upcBgQ7y

Response

A NoContent (204) response indicating that the user access to the catalog was successfully revoked.

Error responses

The following error situations are possible:

ID Response code Description
catalog_id_missing400 (Bad request)No catalog ID was specified.
missing_user400 (Bad request)No user given.
catalog_not_found404 (Not found)The specified catalog was not found.
not_found404 (Not found)Requested account not found.
not_linked_to_organization403 (Forbidden)Calling user is not linked to an organization.
not_permitted403 (Forbidden)Only own organization is accessible.