SWIRLS_
ReferenceSDKClient

API Keys

SDK reference for api keys — Create, list, and revoke API keys for programmatic access.

Create, list, and revoke API keys for programmatic access.

createApiKey

Create a new API key for programmatic access. The secret is only returned once on creation - save it securely.

POST

Usage:

const result = await swirls.client.apiKeys.createApiKey({
  name: '...',
})

Input:

ParameterTypeRequiredDescription
namestringYes
descriptionstringNo
scopesstring[]No
expiresInDaysnumberNo

Output:

FieldTypeDescription
idstring
namestring
descriptionstring | null
secretstring
scopesstring[] | null
expiresAtstring | null
createdAtstring

listApiKeys

List all API keys for the current user

GET

Usage:

const result = await swirls.client.apiKeys.listApiKeys({})

Input:

ParameterTypeRequiredDescription
includeRevokedbooleanNo

revokeApiKey

Revoke an API key. This immediately invalidates the key and cannot be undone.

POST

Usage:

const result = await swirls.client.apiKeys.revokeApiKey({
  apiKeyId: '...',
})

Input:

ParameterTypeRequiredDescription
apiKeyIdstringYes
reasonstringNo

Output:

FieldTypeDescription
successboolean

On this page