# AGNTCY Stateless Runs API

**Canonical:** https://apis.io/apis/agntcy/agntcy-stateless-runs-api/  
**Provider:** AGNTCY — https://apis.io/providers/agntcy/  
**Base URL:** https://schema.oasf.outshift.com/api  
**Documentation:** https://schema.oasf.outshift.com/doc

AGNTCY Stateless Runs API is one of 21 APIs that [AGNTCY](https://apis.io/providers/agntcy/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Stateless Runs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 2 JSON Schemas.

A Run represents an execution of an agent. The output of a Run can be a final result or an interrupt. Result from a run can be retrieved by polling or by blocking and waiting for the result. See `Run` and `RunOutput` models below for more info.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/runs` | Create a Background stateless Run |
| POST | `/runs/search` | Search Stateless Runs |
| POST | `/runs/stream` | Create a stateless run and stream its output |
| POST | `/runs/wait` | Create a stateless run and wait for its output |
| GET | `/runs/{run_id}/wait` | Blocks waiting for the result of the run. |
| GET | `/runs/{run_id}` | Get Run |
| POST | `/runs/{run_id}` | Resume an interrupted Run |
| DELETE | `/runs/{run_id}` | Delete Stateless Run |
| GET | `/runs/{run_id}/stream` | Stream output from Stateless Run |
| POST | `/runs/{run_id}/cancel` | Cancel Stateless Run |

## Machine-readable artifacts (18)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/openapi/agntcy-stateless-runs-api-openapi.yml
- **Swagger** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/openapi/agntcy-oasf-schema-swagger.json
- **Documentation** — https://docs.agntcy.org/oasf/open-agentic-schema-framework/
- **APIReference** — https://schema.oasf.outshift.com/doc
- **Console** — https://schema.oasf.outshift.com/doc
- **SourceCode** — https://github.com/agntcy/oasf
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/json-schema/agntcy-oasf-record.json
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/grpc/agntcy-oasf-types-v1-record.proto
- **APIReference** — https://spec.acp.agntcy.org/
- **SourceCode** — https://github.com/agntcy/acp-spec
- **Documentation** — https://docs.agntcy.org/
- **Documentation** — https://identity-docs.outshift.com/docs/intro/
- **APIReference** — https://identity-docs.outshift.com/docs/api
- **SourceCode** — https://github.com/agntcy/identity-service
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/authentication/agntcy-authentication.yml
- **SourceCode** — https://github.com/agntcy/identity
- **Protobuf** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/grpc/agntcy-identity-node-v1alpha1-id_service.proto
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/json-schema/agntcy-identity-credential-content.jsonschema.json

## Other AGNTCY APIs (12)

- [Agent Directory (DIR)](https://apis.io/apis/agntcy/agent-directory-dir/)
- [AGNTCY Agents API](https://apis.io/apis/agntcy/agntcy-agents-api/)
- [AGNTCY App Service API](https://apis.io/apis/agntcy/agntcy-appservice-api/)
- [AGNTCY Auth Service API](https://apis.io/apis/agntcy/agntcy-authservice-api/)
- [AGNTCY Badge Service API](https://apis.io/apis/agntcy/agntcy-badgeservice-api/)
- [AGNTCY Classes and Objects API](https://apis.io/apis/agntcy/agntcy-classes-and-objects-api/)
- [AGNTCY Device Service API](https://apis.io/apis/agntcy/agntcy-deviceservice-api/)
- [AGNTCY ID Service API](https://apis.io/apis/agntcy/agntcy-idservice-api/)
- [AGNTCY Issuer Service API](https://apis.io/apis/agntcy/agntcy-issuerservice-api/)
- [AGNTCY JSON Schema API](https://apis.io/apis/agntcy/agntcy-json-schema-api/)
- [AGNTCY Policy Service API](https://apis.io/apis/agntcy/agntcy-policyservice-api/)
- [AGNTCY Sample Data API](https://apis.io/apis/agntcy/agntcy-sample-data-api/)

## Tags

Stateless Runs

---

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