---
title: "List agent sections"
method: GET
path: "/v1/agents/{id}/sections"
---

# List agent sections

`GET /v1/agents/{id}/sections`

## Request

- Base URL: `https://api.runbear.io`
- URL: `https://api.runbear.io/v1/agents/{id}/sections`
- Auth: HTTP bearer

List the agent's instruction sections in the order they are added to its instructions. Returns 404 when the agent is not found.

## Path parameters

- `id` string, uuid, required: Agent ID

## Response `200`

Default Response

- AgentSectionsListResponse
  - `sections` AgentSection[], required
    - `id` string, required: Section ID
    - `name` string, required: Section name
    - `content` string, required: Section text
    - `position` integer, required: Zero-based place of the section in the agent's instructions. Read-only: change the order with `PUT /v1/agents/{id}/sections`.
    - `createdAt` string, required: ISO 8601 timestamp when the section was created
    - `updatedAt` string, required: ISO 8601 timestamp when the section was last changed

## Other responses

- `404`: Default Response

---

[API](https://skmtc.dev/runbear/apis/runbear-api.md) - [All operations](https://skmtc.dev/runbear/apis/runbear-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runbear/apis/runbear-api/revisions/c6a9c3066a5a?raw)