Agno

opencollection: 1.0.0
info:
  name: Agno AgentOS API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Agents
    type: folder
  items:
  - info:
      name: List all agents.
      type: http
    http:
      method: GET
      url: http://localhost:7777/agents
    docs: Lists all agents configured on this AgentOS instance.
  - info:
      name: Get an agent.
      type: http
    http:
      method: GET
      url: http://localhost:7777/agents/:agent_id
      params:
      - name: agent_id
        value: ''
        type: path
        description: The ID of the agent.
    docs: Retrieves configuration details for a single agent.
  - info:
      name: Create an agent run.
      type: http
    http:
      method: POST
      url: http://localhost:7777/agents/:agent_id/runs
      params:
      - name: agent_id
        value: ''
        type: path
        description: The ID of the agent.
      body:
        type: form-urlencoded
        data: message=Tell+me+about+Agno&stream=true
    docs: Runs an agent with a message. Returns JSON, or a text/event-stream when stream=true.
  - info:
      name: Cancel a run.
      type: http
    http:
      method: POST
      url: http://localhost:7777/runs/:run_id/cancel
      params:
      - name: run_id
        value: ''
        type: path
        description: The ID of the run to cancel.
    docs: Requests cancellation of an in-progress run.
- info:
    name: Teams
    type: folder
  items:
  - info:
      name: List all teams.
      type: http
    http:
      method: GET
      url: http://localhost:7777/teams
    docs: Retrieves a comprehensive list of all teams configured on this OS instance.
  - info:
      name: Create a team run.
      type: http
    http:
      method: POST
      url: http://localhost:7777/teams/:team_id/runs
      params:
      - name: team_id
        value: ''
        type: path
        description: The ID of the team.
      body:
        type: form-data
        data: message=Research+and+summarize+this+topic&stream=true
    docs: Runs a team of agents against a message.
- info:
    name: Workflows
    type: folder
  items:
  - info:
      name: List all workflows.
      type: http
    http:
      method: GET
      url: http://localhost:7777/workflows
    docs: Lists all workflows configured on this AgentOS instance.
  - info:
      name: Get workflow details.
      type: http
    http:
      method: GET
      url: http://localhost:7777/workflows/:workflow_id
      params:
      - name: workflow_id
        value: ''
        type: path
        description: The ID of the workflow.
    docs: Retrieves a workflow definition.
  - info:
      name: Execute a workflow.
      type: http
    http:
      method: POST
      url: http://localhost:7777/workflows/:workflow_id/runs
      params:
      - name: workflow_id
        value: ''
        type: path
        description: The ID of the workflow.
      body:
        type: form-urlencoded
        data: message=Run+the+workflow&stream=true
    docs: Executes a multi-step workflow. Returns JSON, or text/event-stream when stream=true.
  - info:
      name: Get a workflow run.
      type: http
    http:
      method: GET
      url: http://localhost:7777/workflows/:workflow_id/runs/:run_id
      params:
      - name: workflow_id
        value: ''
        type: path
        description: The ID of the workflow.
      - name: run_id
        value: ''
        type: path
        description: The ID of the run.
    docs: Retrieves a workflow run.
  - info:
      name: Cancel a workflow run.
      type: http
    http:
      method: DELETE
      url: http://localhost:7777/workflows/:workflow_id/runs/:run_id
      params:
      - name: workflow_id
        value: ''
        type: path
        description: The ID of the workflow.
      - name: run_id
        value: ''
        type: path
        description: The ID of the run.
    docs: Cancels a workflow run.
- info:
    name: Sessions
    type: folder
  items:
  - info:
      name: List sessions.
      type: http
    http:
      method: GET
      url: http://localhost:7777/sessions?type=agent&limit=20&page=1
    docs: Lists agent, team, or workflow sessions with filtering and pagination.
  - info:
      name: Create a session.
      type: http
    http:
      method: POST
      url: http://localhost:7777/sessions
      body:
        type: json
        data: "{\n  \"session_name\": \"My Session\"\n}"
    docs: Creates a new session.
  - info:
      name: Get a session.
      type: http
    http:
      method: GET
      url: http://localhost:7777/sessions/:session_id
      params:
      - name: session_id
        value: ''
        type: path
        description: The ID of the session.
    docs: Retrieves a session by ID.
  - info:
      name: Delete a session.
      type: http
    http:
      method: DELETE
      url: http://localhost:7777/sessions/:session_id
      params:
      - name: session_id
        value: ''
        type: path
        description: The ID of the session.
    docs: Deletes a session.
  - info:
      name: List runs in a session.
      type: http
    http:
      method: GET
      url: http://localhost:7777/sessions/:session_id/runs
      params:
      - name: session_id
        value: ''
        type: path
        description: The ID of the session.
    docs: Lists runs belonging to a session.
- info:
    name: Memory
    type: folder
  items:
  - info:
      name: List memories.
      type: http
    http:
      method: GET
      url: http://localhost:7777/memories
    docs: Lists stored memories.
  - info:
      name: Create a memory.
      type: http
    http:
      method: POST
      url: http://localhost:7777/memories
      body:
        type: json
        data: "{\n  \"memory\": \"User prefers concise answers.\",\n  \"user_id\": \"user@example.com\",\n  \"topics\": [\"\
          preferences\"]\n}"
    docs: Creates a new persistent memory.
  - info:
      name: Get memory topics.
      type: http
    http:
      method: GET
      url: http://localhost:7777/memories/topics
    docs: Lists distinct topics/tags used across stored memories.
  - info:
      name: Get user memory statistics.
      type: http
    http:
      method: GET
      url: http://localhost:7777/memories/stats
    docs: Aggregate memory counts and usage per user.
  - info:
      name: Optimize user memories.
      type: http
    http:
      method: POST
      url: http://localhost:7777/memories/optimize
    docs: Consolidates and deduplicates a user's stored memories.
- info:
    name: Knowledge
    type: folder
  items:
  - info:
      name: List knowledge content.
      type: http
    http:
      method: GET
      url: http://localhost:7777/knowledge/content
    docs: Paginated list of all content in the knowledge base.
  - info:
      name: Upload knowledge content.
      type: http
    http:
      method: POST
      url: http://localhost:7777/knowledge/content
      body:
        type: form-data
        data: url=https://example.com/article&name=Example+Article
    docs: Uploads a file, URL, or raw text into the knowledge base.
  - info:
      name: Search knowledge.
      type: http
    http:
      method: GET
      url: http://localhost:7777/knowledge/search?query=pricing
    docs: Searches indexed knowledge content.
- info:
    name: Evals
    type: folder
  items:
  - info:
      name: List evaluation runs.
      type: http
    http:
      method: GET
      url: http://localhost:7777/eval-runs
    docs: Lists evaluation runs.
  - info:
      name: Execute an evaluation.
      type: http
    http:
      method: POST
      url: http://localhost:7777/eval-runs
      body:
        type: json
        data: "{\n  \"eval_type\": \"accuracy\",\n  \"input\": \"What is the capital of France?\",\n  \"agent_id\": \"my-agent\"\
          ,\n  \"expected_output\": \"Paris\"\n}"
    docs: Executes an accuracy, agent-as-judge, performance, or reliability evaluation.
bundled: true