# Diagrid Control Plane API

Diagrid is a durable execution platform for workflows and AI agents. The Diagrid Control Plane API manages the resources they run on, including projects, App IDs, agents, MCP servers, Pub/Sub components, key-value stores, subscriptions, configurations, resiliency policies and HTTP endpoints, as well as organization settings, access and observability. For guides and concepts, see the Diagrid documentation at https://docs.diagrid.io.

The API is in beta: every path is versioned `v1beta1` or `v1beta2`, and its operations and fields can still change.

Request and response bodies are JSON. Send request bodies with a `Content-Type` header of exactly `application/json`, without parameters such as `charset`. Most resources have the shape `apiVersion`, `kind`, `metadata`, `spec` and `status`. Most write operations are processed asynchronously: the request is accepted, and the change is applied afterwards.

## Authentication

**HTTP: Bearer Auth**

- **Security Scheme Type:** http
- **HTTP Authorization Scheme:** bearer
- **Bearer format:** JWT

**API Key: orgId**

- **Security Scheme Type:** apiKey
- **Header parameter name:** x-diagrid-orgid

**API Key: apiKey**

A Diagrid API key. The key belongs to one organization, so a request that sends it needs no `x-diagrid-orgid` header. If the header is sent, it must name the key's organization.

- **Security Scheme Type:** apiKey
- **Header parameter name:** x-diagrid-api-key