---
title: "List scenario chains (agent key required)"
method: GET
path: "/agent/v1/chains"
tags: ["Agent Sandbox"]
---

# List scenario chains (agent key required)

`GET /agent/v1/chains`

The 5 built-in presets plus your own definitions. Invoke any chain by sending X-Agent-Chain: <name> on any /agent/v1 endpoint: each call advances one step; 'ok' steps respond normally, scenario steps respond with that scenario. Position is server-side state with a 24h inactivity TTL. Behaviour is a pure function of (definition, call count).

## Response `200`

{ data: { presets[], custom[] } }

## Other responses

- `401` — No agent key

---

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