---
title: "Run Agent"
method: POST
path: "/agui"
tags: ["AGUI"]
---

# Run Agent

`POST /agui`

## Request body

- RunAgentInput — Input for running an agent.
  - `threadId` string, required
  - `runId` string, required
  - `parentRunId` string, nullable
  - `state` unknown, required
  - `messages` union[], required
    - union
      - DeveloperMessage — A developer message.
        - `id` string, required
        - `role` 'developer'
        - `content` string, required
        - `name` string, nullable
        - `encryptedValue` string, nullable
      - SystemMessage — A system message.
        - `id` string, required
        - `role` 'system'
        - `content` string, required
        - `name` string, nullable
        - `encryptedValue` string, nullable
      - AssistantMessage — An assistant message.
        - `id` string, required
        - `role` 'assistant'
        - `content` string, nullable
        - `name` string, nullable
        - `encryptedValue` string, nullable
        - `toolCalls` ToolCall[], nullable
          - `id` string, required
          - `type` 'function'
          - `function` FunctionCall, required — Name and arguments of a function call.
            - `name` string, required
            - `arguments` string, required
          - `encryptedValue` string, nullable
      - UserMessage — A user message supporting text or multimodal content.
        - `id` string, required
        - `role` 'user'
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `name` string, nullable
        - `encryptedValue` string, nullable
      - ToolMessage — A tool result message.
        - `id` string, required
        - `role` 'tool'
        - `content` string, required
        - `toolCallId` string, required
        - `error` string, nullable
        - `encryptedValue` string, nullable
      - ActivityMessage — An activity progress message emitted between chat messages.
        - `id` string, required
        - `role` 'activity'
        - `activityType` string, required
        - `content` object, required
      - ReasoningMessage — A reasoning message containing the agent's internal reasoning process.
        - `id` string, required
        - `role` 'reasoning'
        - `content` string, required
        - `encryptedValue` string, nullable
  - `tools` Tool[], required
    - `name` string, required
    - `description` string, required
    - `parameters` unknown
  - `context` Context[], required
    - `description` string, required
    - `value` string, required
  - `forwardedProps` unknown, required
  - `resume` ResumeEntry[], nullable
    - `interruptId` string, required
    - `status` 'resolved' | 'cancelled', required
    - `payload` unknown

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/revisions/5f6149d395d0/schema)