Agentuity Documentation

Create and manage API keys for authentication.

Region

https://catalyst-usw.agentuity.cloud

Authentication

All requests require a Bearer token. Pass your SDK key in the Authorization header.

Header	Value
`Authorization`	`Bearer YOUR_SDK_KEY`

You can find your SDK key in the Agentuity Console under your project settings.

Create API Key

Create a new API key. The key value is only returned at creation time.

POST/cli/apikey

https://catalyst-usw.agentuity.cloud/cli/apikey

Request Body

API key creation payload.

Field	Type	Description
`name`	string	Name of the API key
`expiresAt`	string	Expiration timestamp for the API key
`projectId`	string \| null	Optional project scope for the key (optional)
`orgId`	string \| null	Optional organization scope for the key (optional)

Response

Returns the new key ID and value. The value is only returned at creation time.

Status	Description
201	API key created
401	Unauthorized — invalid or missing Bearer token

Response Fields

Field	Type	Description
`id`	string	the API key id
`value`	string	the API key value

Example

curl -X POST 'https://catalyst-usw.agentuity.cloud/cli/apikey' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "My API Key",
  "expiresAt": "2026-12-31T23:59:59Z"
}'

List API Keys

List API keys with optional filtering by organization or project.

GET/cli/apikey

https://catalyst-usw.agentuity.cloud/cli/apikey

Parameters

query

Name	Type	Required	Description
`orgId`	string	No	Filter by organization ID
`projectId`	string	No	Filter by project ID

Response

Array of API key objects.

Status	Description
200	API keys returned
401	Unauthorized — invalid or missing Bearer token

Response Fields

Field	Type	Description
`id`	string	the API key id
`name`	string	the API key name
`orgId`	string	the organization id
`type`	string	the API key type
`expiresAt`	string \| null	the expiration date
`lastUsedAt`	string \| null	the last used date (optional)
`createdAt`	string	the creation date
`project`	object \| null	the associated project (optional)

Example

curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/apikey' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'

Get API Key

Get a specific API key by ID.

GET/cli/apikey/{id}

https://catalyst-usw.agentuity.cloud/cli/apikey/{id}

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	API key ID

Response

API key object.

Status	Description
200	API key returned
401	Unauthorized — invalid or missing Bearer token
404	API key not found

Example

curl -X GET 'https://catalyst-usw.agentuity.cloud/cli/apikey/ak_abc123' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'

Delete API Key

Delete an API key by ID.

DELETE/cli/apikey/{id}

https://catalyst-usw.agentuity.cloud/cli/apikey/{id}

Parameters

path

Name	Type	Required	Description
`id`	string	Yes	API key ID

Response

Empty response on success.

Status	Description
204	API key deleted
401	Unauthorized — invalid or missing Bearer token
404	API key not found

Example

curl -X DELETE 'https://catalyst-usw.agentuity.cloud/cli/apikey/ak_abc123' \
  -H 'Authorization: Bearer $AGENTUITY_SDK_KEY'