# AGNTCY Agents API

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

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

Agents are AI workflows that can be configured and/or executed on this server. This means that a client of this server can start a Run on any of the Agents supported by this server. Each agent may support different features of ACP, also each agent specifies the schemas of the objects carried by ACP for configuration, input, output, interrupts and state. Details of the ACP features and the schemas are kept in the ACP descriptor of the specific agent. This object can be retrieved through this ACP interface or is found in the ACP extension of the agent record in the agent directory. See `Agent` and `AgentACPDescriptor` models below for more info.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents/search` | Search Agents |
| GET | `/agents/{agent_id}` | Get Agent |
| GET | `/agents/{agent_id}/descriptor` | Get Agent ACP Descriptor from its id |

## Machine-readable artifacts (18)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agntcy/refs/heads/main/openapi/agntcy-agents-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 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/)
- [AGNTCY Schema API](https://apis.io/apis/agntcy/agntcy-schema-api/)

## Tags

Agents

---

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