# Letta Runs, Jobs and Steps API

**Canonical:** https://apis.io/apis/letta/letta-runs-jobs-and-steps-api/  
**Provider:** Letta — https://apis.io/providers/letta/  
**Base URL:** https://chat.letta.com  
**Documentation:** https://github.com/letta-ai/letta-code

Letta Runs, Jobs and Steps API is one of 49 APIs that [Letta](https://apis.io/providers/letta/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Runs, Jobs and Steps. The published artifact set on APIs.io includes an OpenAPI specification.

Asynchronous execution history behind agent messages.

## Operations (21)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/runs/` | List Runs |
| GET | `/v1/runs/active` | List Active Runs |
| GET | `/v1/runs/{run_id}` | Retrieve Run |
| DELETE | `/v1/runs/{run_id}` | Delete Run |
| GET | `/v1/runs/{run_id}/messages` | List Messages For Run |
| GET | `/v1/runs/{run_id}/metrics` | Retrieve Metrics For Run |
| GET | `/v1/runs/{run_id}/steps` | List Steps For Run |
| POST | `/v1/runs/{run_id}/stream` | Retrieve Stream For Run |
| GET | `/v1/runs/{run_id}/trace` | Retrieve Trace For Run |
| GET | `/v1/runs/{run_id}/usage` | Retrieve Usage For Run |
| GET | `/v1/jobs/` | List Jobs |
| GET | `/v1/jobs/active` | List Active Jobs |
| GET | `/v1/jobs/{job_id}` | Retrieve Job |
| DELETE | `/v1/jobs/{job_id}` | Delete Job |
| PATCH | `/v1/jobs/{job_id}/cancel` | Cancel Job |
| GET | `/v1/steps/` | List Steps |
| GET | `/v1/steps/{step_id}` | Retrieve Step |
| PATCH | `/v1/steps/{step_id}/feedback` | Modify Feedback For Step |
| GET | `/v1/steps/{step_id}/messages` | List Messages For Step |
| GET | `/v1/steps/{step_id}/metrics` | Retrieve Metrics For Step |
| GET | `/v1/steps/{step_id}/trace` | Retrieve Trace For Step |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/letta/refs/heads/main/openapi/letta-runs-jobs-and-steps-api-openapi.yml

## Other Letta APIs (12)

- [Letta Code](https://apis.io/apis/letta/letta-code/)
- [Letta Admin API](https://apis.io/apis/letta/letta-admin-api/)
- [Letta Agents API](https://apis.io/apis/letta/letta-agents-api/)
- [Letta Archives API](https://apis.io/apis/letta/letta-archives-api/)
- [Letta Blocks API](https://apis.io/apis/letta/letta-blocks-api/)
- [Letta Chat API](https://apis.io/apis/letta/letta-chat-api/)
- [Letta Client-Side Access Tokens API](https://apis.io/apis/letta/letta-client-side-access-tokens-api/)
- [Letta Conversations API](https://apis.io/apis/letta/letta-conversations-api/)
- [Letta Device Storage API](https://apis.io/apis/letta/letta-device-storage-api/)
- [Letta Embeddings API](https://apis.io/apis/letta/letta-embeddings-api/)
- [Letta Environments API](https://apis.io/apis/letta/letta-environments-api/)
- [Letta Feeds API](https://apis.io/apis/letta/letta-feeds-api/)

## Tags

Runs, Jobs and Steps

---

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