Skip to content

List the organization's integration keys

GET
/v1/integrations
curl --request GET \
--url https://example.com/v1/integrations \
--header 'X-API-Key: <X-API-Key>'

The organization’s Hugging Face tokens, newest first: provider, name, the last four characters and whether it is the default. Never the key itself.

Needs integrations:write (a * key does not have it) and Admin on the organization.

Successful Response

Media type application/json
IntegrationList

The organization’s integration keys, newest first.

object
integrations
required
Array<object>
Integration

One integration key, without its value.

object
id
required

The integration key’s ID

string format: uuid
provider
required

The service the key is for

string
Allowed value: huggingface
name
required

The key’s name

string
last4

The key’s last four characters; null for a key shorter than 12

string | null
is_default
required

The Hugging Face token new runs use

boolean
created_by
required

The person who added it

string format: uuid
created_at
required

When it was added

string format: date-time
expires_at
required

When it expires

string format: date-time
Example
{
"integrations": [
{
"provider": "huggingface"
}
]
}

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"
}