Skip to content

Remove an integration key

DELETE
/v1/integrations/{integration_id}
curl --request DELETE \
--url https://example.com/v1/integrations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'X-API-Key: <X-API-Key>'

Remove an integration key. Workspaces that used a removed Hugging Face token move to the default; partner sends need a new key.

Needs integrations:write and Admin on the organization.

integration_id
required
string format: uuid

Successful Response

Media type application/json
IntegrationDeleteResponse

Response for removing an integration key.

object
id
required

The removed key’s ID

string format: uuid
deleted
required

Whether the key was removed

boolean
Example generated
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"deleted": true
}

Invalid or missing API key

Media type application/json
ErrorResponse

Standard error response.

object
detail
required

Error message describing what went wrong

string
Example generated
{
"detail": "example"
}

Missing integrations:write or Admin

Media type application/json
ErrorResponse

Standard error response.

object
detail
required

Error message describing what went wrong

string
Example generated
{
"detail": "example"
}

Not found or access denied

Media type application/json
ErrorResponse

Standard error response.

object
detail
required

Error message describing what went wrong

string
Example generated
{
"detail": "example"
}

Validation Error

Media type application/json
HTTPValidationError
object
detail
Array<object>
ValidationError
object
loc
required
Location
Array<string | integer>
msg
required
Message
string
type
required
Error Type
string
input
ctx
Context
object
Example generated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}