Collections

Remove a resource from a collection

DELETE/collections/{ref}/resources/{resourceRef}

Removes the resource from the collection (the resource itself is untouched). Requires the write scope and modify access to the collection. Returns 404 when the resource is not in the collection, so retries of an already-applied delete fail loudly rather than silently — treat 404 after a retry as "already removed".

X-Api-Key<token>

Issued to you when your integration is provisioned. Determines which catalogue resources are visible and which AI tools are available.

In: header

Path Parameters

ref*integer

Collection id.

resourceRef*integer

Resource id to remove.

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/collections/0/resources/0"
{  "data": {    "removed": true,    "collectionRef": 55,    "resourceRef": 101  }}

{  "success": false,  "status": "fail",  "message": "API key is required",  "error": {    "code": "NO_API_KEY",    "message": "API key is required"  }}

{  "success": false,  "status": "fail",  "message": "This API key does not have the 'write' scope",  "error": {    "code": "INSUFFICIENT_SCOPE",    "message": "This API key does not have the 'write' scope"  }}

{  "success": false,  "status": "fail",  "message": "string",  "error": {    "message": "API key is required",    "code": "NO_API_KEY"  }}