DELETE user/…/catalog/…

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_missing 400 (Bad request) No catalog ID was specified.
missing_user 400 (Bad request) No user given.
catalog_not_found 404 (Not found) The specified catalog was not found.
not_found 404 (Not found) Requested account not found.
not_linked_to_organization 403 (Forbidden) Calling user is not linked to an organization.
not_permitted 403 (Forbidden) Only own organization is accessible.