Skip to content

Create an Agent API Key

client.agents.apiKeys.create(stringagentUuid, APIKeyCreateParams { agent_uuid, name } body?, RequestOptionsoptions?): APIKeyCreateResponse { api_key_info }
post/v2/gen-ai/agents/{agent_uuid}/api_keys

To create an agent API key, send a POST request to /v2/gen-ai/agents/{agent_uuid}/api_keys.

ParametersExpand Collapse
agentUuid: string
body: APIKeyCreateParams { agent_uuid, name }
agent_uuid?: string

Agent id

name?: string

A human friendly name to identify the key

ReturnsExpand Collapse
APIKeyCreateResponse { api_key_info }
api_key_info?: APIAgentAPIKeyInfo { created_at, created_by, deleted_at, 3 more }

Agent API Key Info

created_at?: string

Creation date

formatdate-time
created_by?: string

Created by

formatuint64
deleted_at?: string

Deleted date

formatdate-time
name?: string

Name

secret_key?: string
uuid?: string

Uuid

Create an Agent API Key
import Gradient from '@digitalocean/gradient';

const client = new Gradient({
  accessToken: 'My Access Token',
});

const apiKey = await client.agents.apiKeys.create('"123e4567-e89b-12d3-a456-426614174000"');

console.log(apiKey.api_key_info);
{
  "api_key_info": {
    "created_at": "2023-01-01T00:00:00Z",
    "created_by": "12345",
    "deleted_at": "2023-01-01T00:00:00Z",
    "name": "example name",
    "secret_key": "example string",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
}
Returns Examples
{
  "api_key_info": {
    "created_at": "2023-01-01T00:00:00Z",
    "created_by": "12345",
    "deleted_at": "2023-01-01T00:00:00Z",
    "name": "example name",
    "secret_key": "example string",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
}