# Orq.ai Agents API

**Canonical:** https://apis.io/apis/orq/orq-agents-api/  
**Provider:** Orq.ai — https://apis.io/providers/orq/  
**Base URL:** https://my.orq.ai  
**Documentation:** https://docs.orq.ai/reference

Orq.ai Agents API is one of 59 APIs that [Orq.ai](https://apis.io/providers/orq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Agents API from Orq.ai — 12 operation(s) for agents.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| POST | `/v2/agents` | Create agent |
| GET | `/v2/agents` | List agents |
| POST | `/v2/agents/{agent_key}/responses` | Create response |
| GET | `/v2/agents/{agent_key}/responses/{task_id}` | Get response |
| DELETE | `/v2/agents/{agent_key}` | Delete agent |
| GET | `/v2/agents/{agent_key}` | Retrieve agent |
| PATCH | `/v2/agents/{agent_key}` | Update agent |
| POST | `/v2/agents/{key}/task` | Execute an agent task |
| POST | `/v2/agents/run` | Run an agent with configuration |
| POST | `/v2/agents/stream-run` | Run agent with streaming response |
| POST | `/v2/agents/{key}/stream-task` | Stream agent execution in real-time |
| GET | `/v2/agents/external` | List external agents |
| POST | `/v2/agents/external` | Create external agent |
| GET | `/v2/agents/external/{agent_key}` | Retrieve external agent |
| DELETE | `/v2/agents/external/{agent_key}` | Delete external agent |
| PATCH | `/v2/agents/external/{agent_key}` | Update external agent |
| POST | `/v2/agents/external/{agent_key}:refreshCard` | Refresh external agent card |
| POST | `/v2/agents/external/{agent_key}:testConnection` | Test external agent connection |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/orq/openapi/orq-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-invoke-deployment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-search-knowledge-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-response-stream-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-thought-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-started-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-model-metadata-schema.json

## Other Orq.ai APIs (12)

- [Orq.ai Agent Feedback API](https://apis.io/apis/orq/orq-agent-feedback-api/)
- [Orq.ai Agent Schedules API](https://apis.io/apis/orq/orq-agent-schedules-api/)
- [Orq.ai Alerts API](https://apis.io/apis/orq/orq-alerts-api/)
- [Orq.ai Annotation Queues API](https://apis.io/apis/orq/orq-annotation-queues-api/)
- [Orq.ai Annotations API](https://apis.io/apis/orq/orq-annotations-api/)
- [Orq.ai API keys API](https://apis.io/apis/orq/orq-api-keys-api/)
- [Orq.ai Audio API](https://apis.io/apis/orq/orq-audio-api/)
- [Orq.ai Audit Logs API](https://apis.io/apis/orq/orq-audit-logs-api/)
- [Orq.ai Budgets API](https://apis.io/apis/orq/orq-budgets-api/)
- [Orq.ai Chunking API](https://apis.io/apis/orq/orq-chunking-api/)
- [Orq.ai Classify API](https://apis.io/apis/orq/orq-classify-api/)
- [Orq.ai Completions API](https://apis.io/apis/orq/orq-completions-api/)

## Tags

Agents

---

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