Projects

Returns the canonical Agents owned by this Project with cursor pagination.

Creates a Project Agent identity. Publish an immutable Agent revision separately before selecting it for a Release.

Returns one canonical Project Agent identity and its lifecycle status within the requested Project.

Updates the Project Agent display metadata. Immutable Agent revisions and their content are not changed by this request.

Queues deletion of the Project Agent and returns 202 with the canonical resource. Deletion is rejected with 409 while an active Deployment, enabled Agent Job, non-terminal AgentRun, or live delegation depends on the Agent.

Lists immutable revisions for the canonical Project Agent. Cursors continue the same Project and Agent scope.

Creates one immutable Agent revision. The returned revision ID is the exact pin accepted by Release creation; it does not silently follow a later revision.

Returns the exact immutable Agent revision identified by the URL, without resolving the Agent's latest revision or merging another Agent.

Marks a custom Project Environment for deletion and queues exact owned runtime cleanup. Built-in development, preview, and production Environments are protected and return 409. The response is an asynchronous deletion receipt; it does not claim that provider cleanup has already finished.

Returns the current active Deployment coordinate for this Environment, including its Release and configuration revision. A valid Environment with no active Deployment returns 404; no provider or runtime locator is exposed.

Lists immutable activation records for one exact Project Environment. Use pagination.nextCursor for the next page; the cursor is opaque and bound to this Project/Environment. A missing or inaccessible coordinate is 404, and malformed pagination is 422.

Synchronously activates an eligible ready Deployment and atomically advances this Environment's active pointer and generation. The expectedGeneration field is a compare-and-set guard; non-ready or stale/conflicting requests return 409, while a missing or foreign Project/Environment/Deployment coordinate returns 404.

Returns one immutable Activation for the exact Project Environment coordinate. The response includes the pinned Deployment, Release, configuration revision, generation, actor, and timestamps; an unknown or foreign activation is 404.

Lists Deployments belonging to the exact Project Environment coordinate. Deployment execution state is reported by the returned lifecycle status.

Submits a Deployment using an existing immutable Release and the Environment's existing configuration revision head. Artifact validation occurs before the durable submission; execution is queued asynchronously. Reuse the same Idempotency-Key and payload to safely retry. A mismatched key returns 409, an in-progress claim may return 503 with Retry-After, and missing or incompatible pins return 404 or 422.

Returns one Deployment for the exact Project and Environment coordinate, including its immutable Release and configuration revision pins.

Requests terminal cancellation with an expected-state CAS. Existing materialized resources are retained for cleanup.

Execute an operation from the selected deployment. Definition data constraint failures return 422 with details.invocationId and a safe details.diagnostic. Inspect persisted diagnostics through the operation invocation list. A required auto-managed field must be included in the deployed domain's auto declarations; it must not be supplied manually. Infrastructure failures remain server errors, not input validation errors.

Lists immutable Releases belonging to the Project. Each Release records the exact Agent and Definition revision pins used to build it.

Creates an immutable Release from the explicitly supplied Agent and Definition revision IDs. The server validates the complete pin and delegate graph before accepting the Release.

Returns one immutable Project Release and its revision-pinned manifest; it does not expose provider locators or internal storage details.