Give Feedback

pydo.genai.create_agent_api_key()

Generated on 7 Jul 2026 from pydo version v0.39.0

Copy page as Markdown View page as Markdown

Usage

client.genai.create_agent_api_key(
    agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"",
    body={
        "agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
        "name": "Production Key",
    },
)

Returns JSONRaises HttpResponseError

Description

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

Parameters

agent_uuid string required

Agent id

agent_uuid string optional

Example: "12345678-1234-1234-1234-123456789012"

Agent id

name string optional

Example: Production Key

A human friendly name to identify the key

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

req = {
  "agent_uuid": "\"12345678-1234-1234-1234-123456789012\"",
  "name": "Production Key"
}

resp = client.genai.create_agent_api_key(agent_uuid="\"123e4567-e89b-12d3-a456-426614174000\"", body=req)

Response Example

Show Response Example

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

More Information

See /v2/gen-ai/agents/{agent_uuid}/api_keys in the API reference for additional detail on responses, headers, parameters, and more.