# AGNTCY Threads API

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

AGNTCY Threads 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 Threads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and 2 JSON Schemas.

If supported by the involved agents, Run can be grouped in Threads. When a run is executed on a thread is called Thread Run. At the end of a Thread Run, the server keeps a thread state associated to the thread. A thread keeps track of agent states at every step so that continuity of the context is preserved. Moreover, such a book-keeping enables us some granular controls like debugging, interrupting or replaying a run/invocation. A thread state is a data context defined by the developer and can be anything and it gets passed through from one invocation to another so that business logic is instrumented by data. A thread keeps track of the whole state history. At every step, it also applies a checkpoint, which is primarily a `uuid`, so that it is easier to refer to a chunk of the history. One can easily query the last state, a specific state (by checkpoint id), the whole state history, or, a part of the history (from a checkpoint). See `Thread`, `ThreadState` and `Checkpoint` models below for more info.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/threads` | Create an empty Thread |
| POST | `/threads/search` | Search Threads |
| GET | `/threads/{thread_id}/history` | Get Thread History |
| POST | `/threads/{thread_id}/copy` | Copy Thread |
| GET | `/threads/{thread_id}` | Get Thread |
| DELETE | `/threads/{thread_id}` | Delete a thread. If the thread contains any pending run, deletion fails. |
| PATCH | `/threads/{thread_id}` | Patch Thread |

## Machine-readable artifacts (18)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/openapi/agntcy-threads-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

Threads

---

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