# inference-sh Agents API

**Canonical:** https://apis.io/apis/inference-sh/inference-sh-agents-api/  
**Provider:** inference-sh — https://apis.io/providers/inference-sh/  
**Base URL:** https://api.inference.sh  
**Documentation:** https://inference.sh/docs/api/authentication

inference-sh Agents API is one of 65 APIs that [inference-sh](https://apis.io/providers/inference-sh/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include agents. The published artifact set on APIs.io includes an OpenAPI specification.

The agents API from inference-sh — 45 operation(s) for agents.

## Operations (50)

| Method | Path | Summary |
|---|---|---|
| GET | `/agents` | Get agents |
| POST | `/agents` | Create agents |
| GET | `/agents/hook-events` | Get agents hook events |
| GET | `/agents/internal-tools` | Get agents internal tools |
| POST | `/agents/list` | Create agents list |
| POST | `/agents/message` | Create agents message |
| POST | `/agents/messages` | Create agents messages |
| POST | `/agents/run` | Create agents run |
| DELETE | `/agents/{id}` | Delete agents by id |
| GET | `/agents/{id}` | Get agents by id |
| POST | `/agents/{id}` | Create agents by id |
| POST | `/agents/{id}/a2a/` | Create agents by id a2a |
| POST | `/agents/{id}/a2a/message:send` | Create agents by id a2a message:send |
| POST | `/agents/{id}/a2a/message:stream` | Create agents by id a2a message:stream |
| GET | `/agents/{id}/a2a/tasks` | Get agents by id a2a tasks |
| GET | `/agents/{id}/a2a/tasks/{runID}` | Get agents by id a2a tasks by run id |
| POST | `/agents/{id}/a2a/tasks/{runID}:cancel` | Create agents by id a2a tasks {run id}:cancel |
| GET | `/agents/{id}/a2a/tasks/{runID}:subscribe` | Get agents by id a2a tasks {run id}:subscribe |
| GET | `/agents/{id}/card` | Get agents by id card |
| POST | `/agents/{id}/channel/{provider}` | Create agents by id channel by provider |
| POST | `/agents/{id}/duplicate` | Create agents by id duplicate |
| POST | `/agents/{id}/move` | Create agents by id move |
| DELETE | `/agents/{id}/org-share` | Delete agents by id org share |
| GET | `/agents/{id}/rules` | Get agents by id rules |
| POST | `/agents/{id}/rules` | Create agents by id rules |
| POST | `/agents/{id}/rules/explain` | Create agents by id rules explain |
| POST | `/agents/{id}/rules/preview` | Create agents by id rules preview |
| GET | `/agents/{id}/rules/recent` | Get agents by id rules recent |
| DELETE | `/agents/{id}/rules/{ruleId}` | Delete agents by id rules by rule id |
| PUT | `/agents/{id}/rules/{ruleId}` | Replace agents by id rules by rule id |
| POST | `/agents/{id}/share` | Create agents by id share |
| DELETE | `/agents/{id}/share/{userId}` | Delete agents by id share by user id |
| GET | `/agents/{id}/shares` | Get agents by id shares |
| POST | `/agents/{id}/slack` | Create agents by id slack |
| DELETE | `/agents/{id}/team-share` | Delete agents by id team share |
| POST | `/agents/{id}/transfer` | Create agents by id transfer |
| GET | `/agents/{id}/versions` | Get agents by id versions |
| POST | `/agents/{id}/versions/list` | Create agents by id versions list |
| GET | `/agents/{id}/versions/{versionId}` | Get agents by id versions by version id |
| POST | `/agents/{id}/visibility` | Create agents by id visibility |
| GET | `/agents/{namespace}/{name}` | Get agents by namespace by name |
| POST | `/agents/{namespace}/{name}/a2a/` | Create agents by namespace by name a2a |
| POST | `/agents/{namespace}/{name}/a2a/message:send` | Create agents by namespace by name a2a message:send |
| POST | `/agents/{namespace}/{name}/a2a/message:stream` | Create agents by namespace by name a2a message:stream |
| GET | `/agents/{namespace}/{name}/a2a/tasks` | Get agents by namespace by name a2a tasks |
| GET | `/agents/{namespace}/{name}/a2a/tasks/{runID}` | Get agents by namespace by name a2a tasks by run id |
| POST | `/agents/{namespace}/{name}/a2a/tasks/{runID}:cancel` | Create agents by namespace by name a2a tasks {run id}:cancel |
| GET | `/agents/{namespace}/{name}/a2a/tasks/{runID}:subscribe` | Get agents by namespace by name a2a tasks {run id}:subscribe |
| GET | `/agents/{namespace}/{name}/card` | Get agents by namespace by name card |
| POST | `/agents/{namespace}/{name}/openai/chat/completions` | Create agents by namespace by name openai chat completions |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/inference-sh/openapi/inference-sh-agents-api-openapi.yml

## Other inference-sh APIs (12)

- [inference-sh Agent Runs API](https://apis.io/apis/inference-sh/inference-sh-agent-runs-api/)
- [inference-sh API Keys API](https://apis.io/apis/inference-sh/inference-sh-api-keys-api/)
- [inference-sh Apps API](https://apis.io/apis/inference-sh/inference-sh-apps-api/)
- [inference-sh Artifacts API](https://apis.io/apis/inference-sh/inference-sh-artifacts-api/)
- [inference-sh Auth API](https://apis.io/apis/inference-sh/inference-sh-auth-api/)
- [inference-sh Auth Providers API](https://apis.io/apis/inference-sh/inference-sh-auth-providers-api/)
- [inference-sh Billing API](https://apis.io/apis/inference-sh/inference-sh-billing-api/)
- [inference-sh Bounties API](https://apis.io/apis/inference-sh/inference-sh-bounties-api/)
- [inference-sh Chats API](https://apis.io/apis/inference-sh/inference-sh-chats-api/)
- [inference-sh Companies API](https://apis.io/apis/inference-sh/inference-sh-companies-api/)
- [inference-sh Consent API](https://apis.io/apis/inference-sh/inference-sh-consent-api/)
- [inference-sh Content API](https://apis.io/apis/inference-sh/inference-sh-content-api/)

## Tags

agents

---

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