# Agenta Sessions API

**Canonical:** https://apis.io/apis/agenta/agenta-sessions-api/  
**Provider:** Agenta — https://apis.io/providers/agenta/  
**Base URL:** https://eu.cloud.agenta.ai/api  
**Documentation:** https://docs.agenta.ai/reference/api/list-api-endpoints

Agenta Sessions API is one of 37 APIs that [Agenta](https://apis.io/providers/agenta/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Sessions. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Agent sessions — runner coordination (invoke/cancel/steer/attach/detach/heartbeat/liveness), state persistence (durable SDK state and sandbox resume pointer), records, and streams.

## Operations (45)

| Method | Path | Summary |
|---|---|---|
| POST | `/sessions/tools/current` | Get Current Session |
| GET | `/sessions/streams/` | Fetch Session Stream |
| POST | `/sessions/streams/` | Set Session Stream |
| DELETE | `/sessions/streams/` | Delete Session Stream |
| POST | `/sessions/streams/query` | Query Session Streams |
| POST | `/sessions/streams/detach` | Detach Session Stream |
| POST | `/sessions/streams/heartbeat` | Heartbeat Session Stream |
| PUT | `/sessions/streams/header` | Set Session Stream Header |
| POST | `/sessions/streams/header` | Set Session Stream Header |
| GET | `/sessions/streams/watch` | Watch Session Stream |
| GET | `/sessions/{session_id}/events` | Session Events |
| GET | `/sessions/watch` | Watch Project |
| POST | `/sessions/interactions/` | Create Interaction |
| POST | `/sessions/interactions/query` | Query Interactions |
| POST | `/sessions/interactions/transition` | Transition Interaction |
| POST | `/sessions/interactions/cancel-stale` | Cancel Stale Interactions |
| GET | `/sessions/interactions/{interaction_id}` | Fetch Interaction |
| POST | `/sessions/interactions/{interaction_id}/respond` | Respond Interaction |
| POST | `/sessions/attachments` | Create Session Attachment |
| GET | `/sessions/attachments/{attachment_id}/content` | Download Session Attachment Content |
| POST | `/sessions/attachments/reference` | Reference Session Attachments |
| GET | `/sessions/mounts/` | Fetch Session Mounts |
| POST | `/sessions/mounts/query` | Query Session Mounts |
| POST | `/sessions/mounts/sign` | Sign Session Mount Credentials |
| POST | `/sessions/mounts/files/upload` | Upload Session Cwd File |
| POST | `/sessions/mounts/{mount_id}/files/upload` | Upload Session Mount File |
| GET | `/sessions/mounts/{mount_id}/files/download` | Download Session Mount File |
| POST | `/sessions/records/query` | Query Records |
| GET | `/sessions/records/{record_id}` | Get Record Event |
| POST | `/sessions/records/ingest` | Ingest Record Event |
| POST | `/sessions/records/incomplete` | Mark Records Incomplete |
| POST | `/sessions/turns/` | Append Turn |
| POST | `/sessions/turns/complete` | Complete Turn |
| POST | `/sessions/turns/query` | Query Turns |
| GET | `/sessions/turns/{turn_id}` | Fetch Turn |
| POST | `/sessions/query` | Query Sessions |
| DELETE | `/sessions/` | Delete Session |
| PATCH | `/sessions/{session_id}/inputs/{input_id}` | Update Pending Input |
| DELETE | `/sessions/{session_id}/inputs/{input_id}` | Remove Pending Input |
| POST | `/sessions/archive` | Archive Session |
| POST | `/sessions/unarchive` | Unarchive Session |
| GET | `/sessions/{session_id}` | Get Session Snapshot |
| POST | `/sessions/{session_id}/cancel` | Cancel Session Execution |
| POST | `/sessions/{session_id}/continuations/resume` | Resume Session Continuation |
| POST | `/sessions/{session_id}/inputs/{input_id}/send-now` | Send Pending Input Now |

## Machine-readable artifacts (13)

- **OpenAPI** — https://artifacts.apis.io/agenta/openapi/agenta-sessions-api-openapi.yml
- **Documentation** — https://docs.agenta.ai/prompt-engineering/overview
- **APIReference** — https://docs.agenta.ai/reference/api/list-api-endpoints
- **PostmanCollection** — https://artifacts.apis.io/agenta/collections/agenta.postman_collection.json
- **OpenCollection** — https://artifacts.apis.io/agenta/collections/agenta.opencollection.json
- **Documentation** — https://docs.agenta.ai/prompt-engineering/integrating-prompts/fetch-prompt-programatically
- **APIReference** — https://docs.agenta.ai/reference/sdk/configuration-management
- **Documentation** — https://docs.agenta.ai/evaluation/overview
- **APIReference** — https://docs.agenta.ai/reference/api/evaluations
- **Documentation** — https://docs.agenta.ai/evaluation/create-test-sets
- **APIReference** — https://docs.agenta.ai/reference/api/testsets
- **Documentation** — https://docs.agenta.ai/observability/overview
- **APIReference** — https://docs.agenta.ai/reference/api/traces

## Other Agenta APIs (12)

- [Agenta Applications API](https://apis.io/apis/agenta/agenta-applications-api/)
- [Agenta Evaluations API](https://apis.io/apis/agenta/agenta-evaluations-api/)
- [Agenta Evaluators API](https://apis.io/apis/agenta/agenta-evaluators-api/)
- [Agenta Traces API](https://apis.io/apis/agenta/agenta-traces-api/)
- [Agenta Access API](https://apis.io/apis/agenta/agenta-access-api/)
- [Agenta Admin API](https://apis.io/apis/agenta/agenta-admin-api/)
- [Agenta Annotations API](https://apis.io/apis/agenta/agenta-annotations-api/)
- [Agenta Billing API](https://apis.io/apis/agenta/agenta-billing-api/)
- [Agenta Channels API](https://apis.io/apis/agenta/agenta-channels-api/)
- [Agenta Deprecated API](https://apis.io/apis/agenta/agenta-deprecated-api/)
- [Agenta Environments API](https://apis.io/apis/agenta/agenta-environments-api/)
- [Agenta Events API](https://apis.io/apis/agenta/agenta-events-api/)

## Tags

Sessions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agenta/agenta-sessions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agenta/.