Get run status

GET

runs

{run_id}

Get run status

curl --request GET \
  --url http://localhost:8000/runs/{run_id}

{
  "agent_name": "chat",
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "created",
  "output": [
    {
      "role": "<string>",
      "parts": [
        {
          "content_type": "text/plain",
          "name": "<string>",
          "content": "<string>",
          "content_encoding": "plain",
          "content_url": "<string>",
          "metadata": {
            "kind": "citation",
            "start_index": 123,
            "end_index": 123,
            "url": "<string>",
            "title": "<string>",
            "description": "<string>"
          }
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "await_request": {},
  "error": {
    "code": "server_error",
    "message": "<string>",
    "data": {}
  },
  "finished_at": "2023-11-07T05:31:56Z"
}

Path Parameters

run_id

string<uuid>

required

UUID of the run. Identifier of a run

Response

Run status

agent_name

string

required

A unique identifier for the agent following the RFC 1123 DNS label naming convention.

Required string length: 1 - 63

Example:

"chat"

run_id

string<uuid>

required

Identifier of a run

status

enum<string>

required

Status of the run

Available options:

created,

in-progress,

awaiting,

cancelling,

cancelled,

completed,

failed

output

object[]

required

Show child attributes

output.role

string

required

Specifies the sender of the message. Allowed values:

"user" for messages sent by an end-user.
"agent for anonymous agent.
"agent/{agent_name}" for messages sent by an agent, where {agent_name} is the identifier of the agent.

output.parts

object[]

required

Ordered sequence of message parts

Minimum array length: 1

Show child attributes

output.parts.content_type

string

default:text/plain

required

output.parts.name

string

output.parts.content

string

output.parts.content_encoding

enum<string>

default:plain

Available options:

plain,

base64

output.parts.content_url

string<uri>

output.parts.metadata

object

Represents an inline citation, providing info about information source. This is supposed to be rendered as an inline icon, optionally marking a text range it belongs to. If CitationMetadata is included together with content in the message part, the citation belongs to that content and renders at the MessagePart position. This way may be used for non-text content, like images and files. Alternatively, start_index and end_index may define a text range, counting characters in the current Message across all MessageParts with content type text/*, where the citation will be rendered. If one of start_index and end_index is missing or their values are equal, the citation renders only as an inline icon at that position. If both start_index and end_index are not present and MessagePart has no content, the citation renders as inline icon only at the MessagePart position.

Option 1
Option 2

Show child attributes

output.parts.metadata.kind

string

default:citation

required

Allowed value: "citation"

output.parts.metadata.start_index

integer | null

output.parts.metadata.end_index

integer | null

output.parts.metadata.url

string | null

output.parts.metadata.title

string | null

output.parts.metadata.description

string | null

Accompanying text, which may be a general description of the source document, or a specific snippet.

output.created_at

string<date-time>

output.completed_at

string<date-time>

created_at

string<date-time>

required

session_id

string<uuid>

Identifier of a session

await_request

object

Payload describing what is awaited from the client to continue the run.

error

object

Show child attributes

error.code

enum<string>

required

Available options:

server_error,

invalid_input,

not_found

error.message

string

required

error.data

object

finished_at

string<date-time>

List run eventsReturns a list of events emitted by the run.

⌘I

Get run status

curl --request GET \
  --url http://localhost:8000/runs/{run_id}

{
  "agent_name": "chat",
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "created",
  "output": [
    {
      "role": "<string>",
      "parts": [
        {
          "content_type": "text/plain",
          "name": "<string>",
          "content": "<string>",
          "content_encoding": "plain",
          "content_url": "<string>",
          "metadata": {
            "kind": "citation",
            "start_index": 123,
            "end_index": 123,
            "url": "<string>",
            "title": "<string>",
            "description": "<string>"
          }
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "await_request": {},
  "error": {
    "code": "server_error",
    "message": "<string>",
    "data": {}
  },
  "finished_at": "2023-11-07T05:31:56Z"
}

Introduction

Core Concepts

How To

REST API

Integrations

About

Path Parameters

Response