Pods

A Pod is a logical container inside a workspace: think project or environment. Workflows, executions, schedules, and webhooks all live under a pod.

Endpoints

POST /v1/workspaces/:workspaceId/pods

Create a pod. Requires editor+.

Body

{ "name": "Production", "description": "Live workflows" }

A URL-safe slug is auto-generated from the name (e.g. production-a3f2).

Response 201

{ "id": "uuid", "name": "Production", "slug": "production-a3f2", "workspaceId": "..." }

GET /v1/workspaces/:workspaceId/pods

List all pods in the workspace.

Response 200: array of pod objects

GET /v1/workspaces/:workspaceId/pods/:podId

Get a single pod.

Response 200: pod object

PATCH /v1/workspaces/:workspaceId/pods/:podId

Update name or description. Requires editor+.

Body: any subset of { name, description }

Response 200

DELETE /v1/workspaces/:workspaceId/pods/:podId

Delete a pod and all workflows/executions within it. Requires admin+.

Response 204

Pod Object

{
  "id": "uuid",
  "workspaceId": "uuid",
  "name": "Production",
  "slug": "production-a3f2",
  "description": "Live workflows",
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z"
}