{
  "operation": "Create Agent",
  "method": "POST",
  "path": "/v1/agents/",
  "auth": "Bearer token (LETTA_API_KEY)",
  "request": {
    "method": "POST",
    "path": "/v1/agents",
    "headers": {
      "Authorization": "Bearer $LETTA_API_KEY",
      "Content-Type": "application/json"
    },
    "body": {
      "name": "support-agent-1",
      "model": "openai/gpt-4.1",
      "embedding": "openai/text-embedding-3-small",
      "memory_blocks": [
        {
          "label": "persona",
          "value": "You are a calm, patient API support agent. You remember every customer interaction.",
          "limit": 2000
        },
        {
          "label": "human",
          "value": "The user is Kin Lane, founder of API Evangelist.",
          "limit": 1000
        }
      ],
      "tools": [
        "web_search",
        "run_code"
      ],
      "include_base_tools": true
    }
  },
  "response": {
    "status": 201,
    "body": {
      "id": "agent-2f6d4a13-5e9c-4b7e-a3f1-7b8e9c1d2e34",
      "name": "support-agent-1",
      "created_at": "2026-05-22T10:00:00Z",
      "llm_config": {
        "model": "gpt-4.1",
        "model_endpoint_type": "openai"
      },
      "embedding_config": {
        "embedding_model": "text-embedding-3-small"
      },
      "memory": {
        "blocks": [
          {
            "id": "block-a1",
            "label": "persona",
            "value": "You are a calm, patient API support agent.",
            "limit": 2000
          },
          {
            "id": "block-b2",
            "label": "human",
            "value": "The user is Kin Lane, founder of API Evangelist.",
            "limit": 1000
          }
        ]
      },
      "tools": [
        {
          "name": "web_search"
        },
        {
          "name": "run_code"
        },
        {
          "name": "core_memory_append"
        },
        {
          "name": "core_memory_replace"
        },
        {
          "name": "conversation_search"
        },
        {
          "name": "archival_memory_insert"
        }
      ]
    }
  }
}