DELETE user/…/catalog

Revokes catalog permission for a user.

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

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

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

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`

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

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.

Last updated on 2025-10-22