> ## Documentation Index
> Fetch the complete documentation index at: https://help.statisfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one agent

> Returns one agent with its instructions, its toolkits (by key), its skills and its knowledge bases. Fetched by id only: names are not unique. An agent is a custom agent from Agent Studio's Agents tab: instructions it follows, and the toolkits, skills and knowledge bases it may use. `source` says whether Statisfy ships it or the workspace built it.



## OpenAPI

````yaml /api/statisfy-api.openapi.json get /v1/agents/{agent_id}
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/agents/{agent_id}:
    get:
      tags:
        - agents
      summary: Get one agent
      description: >-
        Returns one agent with its instructions, its toolkits (by key), its
        skills and its knowledge bases. Fetched by id only: names are not
        unique. An agent is a custom agent from Agent Studio's Agents tab:
        instructions it follows, and the toolkits, skills and knowledge bases it
        may use. `source` says whether Statisfy ships it or the workspace built
        it.
      operationId: agents_get
      parameters:
        - description: The agent's id, from GET /v1/agents
          in: path
          name: agent_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentDetail'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    AgentDetail:
      properties:
        context:
          description: >-
            global (runs about nothing in particular) or account (runs about one
            account)
          enum:
            - global
            - account
          title: Context
          type: string
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Created At
        created_by:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The user who built it, an id from GET /v1/objects/user/records; null
            for a Statisfy agent, or a user who is gone
          title: Created By
        customized:
          description: >-
            Whether this workspace changed a Statisfy agent from its defaults;
            false for a workspace's own
          title: Customized
          type: boolean
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        id:
          title: Id
          type: string
        instructions:
          description: What the agent is told to do
          title: Instructions
          type: string
        knowledge_bases:
          description: >-
            The knowledge bases it searches, by id. Those it shares are in GET
            /v1/knowledge_bases; one holding its own uploaded files is not
          items:
            type: string
          title: Knowledge Bases
          type: array
        max_tool_calls:
          description: The most tool calls it makes in one run
          title: Max Tool Calls
          type: integer
        name:
          title: Name
          type: string
        reasoning:
          description: How much it reasons before it answers
          enum:
            - auto
            - low
            - medium
            - high
          title: Reasoning
          type: string
        skills:
          description: The skills it may load, by key from GET /v1/skills
          items:
            type: string
          title: Skills
          type: array
        source:
          description: >-
            statisfy (shipped by Statisfy, in the app's Statisfy Library) or
            workspace (built by this workspace)
          enum:
            - statisfy
            - workspace
          title: Source
          type: string
        status:
          description: active, draft or archived
          enum:
            - draft
            - active
            - archived
          title: Status
          type: string
        tools:
          items:
            $ref: '#/components/schemas/AgentToolkit'
          title: Tools
          type: array
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          description: ISO 8601 UTC
          title: Updated At
      required:
        - id
        - name
        - description
        - status
        - source
        - customized
        - context
        - created_by
        - created_at
        - updated_at
        - instructions
        - reasoning
        - max_tool_calls
        - tools
        - skills
        - knowledge_bases
      title: AgentDetail
      type: object
    AgentToolkit:
      properties:
        excluded:
          description: Tools of the toolkit it may not use
          items:
            type: string
          title: Excluded
          type: array
        guidance:
          anyOf:
            - type: string
            - type: 'null'
          description: What it is told about when and how to use this toolkit
          title: Guidance
        toolkit:
          description: The toolkit's key, such as crm or slack
          title: Toolkit
          type: string
        tools:
          anyOf:
            - const: all
              type: string
            - items:
                type: string
              type: array
          description: '"all", or the names of the toolkit''s tools it may use'
          title: Tools
      required:
        - toolkit
        - tools
        - excluded
        - guidance
      title: AgentToolkit
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.