# Orquesta Agent Mesh API

**Canonical:** https://apis.io/apis/getorquesta-com/getorquesta-com-agent-mesh-api/  
**Provider:** Orquesta — https://apis.io/providers/getorquesta-com/  
**Base URL:** https://getorquesta.com  
**Documentation:** https://getorquesta.com/docs

Orquesta Agent Mesh API is one of 8 APIs that [Orquesta](https://apis.io/providers/getorquesta-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Agent Mesh. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Who may ask whom inside an organization, as code: export a declarative document, edit it, plan (a diff that changes nothing) and apply. Needs an org API key (`oak_`) with the opt-in scopes `mesh:read` / `mesh:write` (writing: org-wide key whose creator is owner/admin). `oat_` reads its own neighbourhood and never writes. The organization id is `organizationId` in `GET /api/v1/projects`. The same flow is exposed over MCP (`mesh_get`, `mesh_plan`, `mesh_apply`, `mesh_status`). Guide: /docs#mcp-mesh-code.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/organizations/{orgId}/mesh/export` | Export the mesh as a document |
| POST | `/api/organizations/{orgId}/mesh/plan` | Plan a change (diff only, nothing applied) |
| POST | `/api/organizations/{orgId}/mesh/apply` | Apply a plan atomically |
| GET | `/api/organizations/{orgId}/mesh/plans` | Recent plans |
| GET | `/api/organizations/{orgId}/mesh/plans/{planId}` | Plan status |
| POST | `/api/organizations/{orgId}/mesh/plans/{planId}` | Approve or reject a plan |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/getorquesta-com/openapi/getorquesta-com-agent-mesh-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/getorquesta-com/json-schema/getorquesta-com-mesh-document-schema.json
- **APIsJSON** — https://artifacts.apis.io/getorquesta-com/apis.yml

## Other Orquesta APIs (7)

- [Orquesta Agents API](https://apis.io/apis/getorquesta-com/getorquesta-com-agents-api/)
- [Orquesta Batuta LLM API](https://apis.io/apis/getorquesta-com/getorquesta-com-batuta-llm-api/)
- [Orquesta Logs API](https://apis.io/apis/getorquesta-com/getorquesta-com-logs-api/)
- [Orquesta Projects API](https://apis.io/apis/getorquesta-com/getorquesta-com-projects-api/)
- [Orquesta Prompts API](https://apis.io/apis/getorquesta-com/getorquesta-com-prompts-api/)
- [Orquesta Users API](https://apis.io/apis/getorquesta-com/getorquesta-com-users-api/)
- [Orquesta Workstreams API](https://apis.io/apis/getorquesta-com/getorquesta-com-workstreams-api/)

## Tags

Agent Mesh

---

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