---
title: Agents
description: Agent CRUD and management
full: false
_openapi:
  toc:
    - depth: 2
      title: List agents
      url: '#list-agents'
    - depth: 2
      title: Create agent
      url: '#create-agent'
    - depth: 2
      title: Get agent
      url: '#get-agent'
    - depth: 2
      title: Update agent
      url: '#update-agent'
    - depth: 2
      title: Delete agent
      url: '#delete-agent'
    - depth: 2
      title: Get agent username
      url: '#get-agent-username'
    - depth: 2
      title: Set agent username
      url: '#set-agent-username'
    - depth: 2
      title: Get agent API key
      url: '#get-agent-api-key'
    - depth: 2
      title: Create agent API key
      url: '#create-agent-api-key'
    - depth: 2
      title: List agent revisions
      url: '#list-agent-revisions'
    - depth: 2
      title: List agent content
      url: '#list-agent-content'
  structuredData:
    headings:
      - content: List agents
        id: list-agents
      - content: Create agent
        id: create-agent
      - content: Get agent
        id: get-agent
      - content: Update agent
        id: update-agent
      - content: Delete agent
        id: delete-agent
      - content: Get agent username
        id: get-agent-username
      - content: Set agent username
        id: set-agent-username
      - content: Get agent API key
        id: get-agent-api-key
      - content: Create agent API key
        id: create-agent-api-key
      - content: List agent revisions
        id: list-agent-revisions
      - content: List agent content
        id: list-agent-content
    contents:
      - content: List agents for the authenticated user, or all public agents.
        heading: list-agents
      - content: Create a new agent with optional configuration.
        heading: create-agent
      - content: >-
          Generate a new API key for the agent. The full key is returned only
          once.
        heading: create-agent-api-key
      - content: List configuration revisions (version history) for the agent.
        heading: list-agent-revisions
      - content: List uploaded content (files, images, documents) for an agent.
        heading: list-agent-content
---

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document={"./openapi.json"} webhooks={[]} operations={[{"path":"/api/agents","method":"get"},{"path":"/api/agents","method":"post"},{"path":"/api/agents/{id}","method":"get"},{"path":"/api/agents/{id}","method":"patch"},{"path":"/api/agents/{id}","method":"delete"},{"path":"/api/agents/{id}/username","method":"get"},{"path":"/api/agents/{id}/username","method":"put"},{"path":"/api/agents/{id}/api-key","method":"get"},{"path":"/api/agents/{id}/api-key","method":"post"},{"path":"/api/agents/{id}/revisions","method":"get"},{"path":"/api/agents/{id}/content","method":"get"}]} showTitle />