Create an Environment Agent revision
POST /api/v1/projects/{projectId}/environments/{environmentId}/agents/{agentId}/revisions
Parameters
path
| Name | Type | Required | Description |
|---|---|---|---|
projectId | string | required | Identifies the Project that owns the addressed resource. Applies to Create an Environment Agent revision. |
environmentId | string | required | Identifies the Project environment addressed by the operation. Applies to Create an Environment Agent revision. |
agentId | string | required | Identifies the Project Agent being addressed. Applies to Create an Environment Agent revision. |
Request body
Required — Request body for: Create an Environment Agent revision.
application/json
| Name | Type | Required | Description |
|---|---|---|---|
content | object | required | |
grantedOperations | array<"agents:invoke-operation" | "agents:manage-workflows" | "agents:render-presentation" | "projects:list" | "projects:get" | "projects:create" | "projects:update" | "projects:delete" | "projects:read-runtime-data" | "analytics:read" | "deployments:create" | "activations:create" | "provider-credentials:list" | "provider-credentials:get" | "provider-credentials:create" | "provider-credentials:update" | "provider-credentials:delete" | "provider-credentials:versions:create" | "organizations:create" | "organizations:accept-invitation" | "users:update" | "organizations:get" | "organizations:delete" | "organizations:update" | "organizations:manage-user-groups" | "organizations:manage-members" | "organization-variables:list" | "organization-variables:manage" | "connections:list" | "connections:get" | "connections:create" | "connections:update" | "connections:delete" | "external-integrations:create" | "external-integrations:get" | "external-integrations:invoke" | "api-keys:list" | "api-keys:get" | "api-keys:create" | "api-keys:revoke" | "definitions:list" | "definitions:get" | "definitions:create" | "definitions:update" | "definitions:delete" | "operation-invocations:list" | "operation-approvals:list" | "operation-approvals:approve" | "operation-approvals:reject" | "agents:get" | "agents:list" | "agents:revisions:create" | "agents:revisions:get" | "agents:revisions:list" | "agents:delete" | "agents:push" | "agent-runs:cancel" | "agent-runs:continue" | "agent-runs:create" | "agent-runs:personalize" | "agent-runs:get" | "agent-runs:list" | "agent-runs:read-organization-system-runs" | "agent-runs:stream" | "agent-runs:steps:get" | "agent-runs:steps:list" | "agent-runs:steps:checkpoints:get" | "agent-runs:checkpoints:list" | "agent-jobs:list" | "agent-jobs:get" | "agent-jobs:create" | "agent-jobs:update" | "agent-jobs:delete" | "agent-jobs:run-now" | "webhooks:list" | "webhooks:create" | "webhooks:delete" | "webhooks:rotate-secret" | "webhooks:replay" | "webhooks:retry-dead" | "templates:search" | "templates:read" | "billing:read" | "billing:manage" | "work-memory:read" | "tenants:manage"> | optional |
Responses
| Status | Description | Body |
|---|---|---|
201 | Response for status 201 | application/json — object — type: "agentRevision" (required); id: string (required); agentId: string (required); revisionNumber: integer (required); content: object (required); grantedOperations: array<string> (required); createdBy: string (required); createdAt: string (required); contentDigest: string (required); delegateAgents: array<object> (required) |
400 | The request is malformed or cannot be processed. | application/json — PublicApiError — error: object (required) |
401 | Authentication failed. The Authorization header is missing, or the credential is invalid or expired. | application/json — PublicApiError — error: object (required) |
403 | Access denied. The authenticated user does not have permission to perform this action. | application/json — PublicApiError — error: object (required) |
404 | Resource not found. | application/json — PublicApiError — error: object (required) |
409 | Request conflicts with current state of the resource, including safe deployment conflict classifications. | application/json — PublicApiError — error: object (required) |
422 | Request validation failed. Check the request body, query parameters, or path parameters. | application/json — PublicApiError — error: object (required) |
429 | Too many requests. | application/json — PublicApiError — error: object (required) |
500 | The server could not complete the request. | application/json — PublicApiError — error: object (required) |
503 | Service temporarily unavailable (e.g. execution capacity exhausted). The response carries a Retry-After header; retry with backoff. | application/json — PublicApiError — error: object (required) |