> ## Documentation Index > Fetch the complete documentation index at: https://docs.zapier.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Agentic Management config for a workflow > Updates the active agentic modes, the auto-approve setting, or both, for a workflow. Send only the fields you want to change: `modes` replaces the current set atomically, and `auto_approve` can be flipped on its own without re-sending `modes`. At least one of the two must be present. To turn Agentic Management off, call `DELETE /api/v0/agma/{workflow_id}`. An empty `modes` array is rejected rather than treated as a clear-all. ## OpenAPI ````yaml /api-reference/specs/agentic-management.yaml patch /agentic-management/v0/{workflow_id} openapi: 3.1.0 info: title: Agentic Management description: >- Agentic Management for a next-gen Zap workflow — turn management on or off, read and update its modes and approval policy, list the runs it has taken, and record the owner-declared intent a version exists to serve. version: 1.0.0 contact: url: https://docs.zapier.com servers: - url: https://api.zapier.com description: Production security: - OAuth: [] tags: - name: Automations description: Background automation lifecycle and run management - name: Harness description: >- The agent harness platform surface: chats, turns, tool-call resolution, events, files, and model discovery. The operations that carry this tag form the slice the Zapier agent harness client is generated from. paths: /agentic-management/v0/{workflow_id}: patch: tags: - Automations - Harness summary: Update Agentic Management config for a workflow description: >- Updates the active agentic modes, the auto-approve setting, or both, for a workflow. Send only the fields you want to change: `modes` replaces the current set atomically, and `auto_approve` can be flipped on its own without re-sending `modes`. At least one of the two must be present. To turn Agentic Management off, call `DELETE /api/v0/agma/{workflow_id}`. An empty `modes` array is rejected rather than treated as a clear-all. operationId: updateAgenticManagementConfig parameters: - name: workflow_id in: path required: true schema: type: string format: uuid description: Workflow ID to update. requestBody: required: true content: application/json: examples: replace_modes: summary: Replace the active mode set value: modes: - heal - harden require_approval_only: summary: Require approval for each fix, leaving the active modes alone value: auto_approve: false replace_modes_and_approval: summary: Replace the active mode set and set auto-approve together value: modes: - heal auto_approve: false schema: type: object minProperties: 1 additionalProperties: false properties: modes: type: array minItems: 1 uniqueItems: true items: type: string enum: - heal - expand - harden description: >- Agentic modes to activate. Replaces the current set. Omit to leave the active modes unchanged. auto_approve: type: boolean description: >- When true, Agentic Management applies its fixes without asking the owner to approve each one. When false, the owner approves each fix before it commits. Omit to leave the current setting unchanged. responses: '200': description: OK content: application/json: schema: type: object required: - workflow_id - modes - auto_approve properties: workflow_id: type: string format: uuid description: The workflow whose config was updated. modes: type: array description: Active agentic modes after the update. items: type: string enum: - heal - expand - harden auto_approve: type: boolean description: Auto-approve state after the update. '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' '403': description: >- Forbidden. The caller is not the workflow's creator, or Agentic Management is switched off for the account. content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' '429': description: >- Too Many Requests. The request exceeded the per-user rate limit for `/api/v0/agma/{workflow_id}`. This budget is shared with the GET and DELETE operations on the same path. content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' '503': description: >- Service Unavailable. Agentic Management could not confirm that this account is eligible. Nothing was read or changed, so the same request is safe to retry. A `403` is different. It is a definite answer that this account cannot use Agentic Management. content: application/json: schema: $ref: '#/components/schemas/ErrorsResponse' components: schemas: ErrorsResponse: type: object properties: errors: description: A collection of the errors returned. type: array items: $ref: '#/components/schemas/ErrorObject' required: - errors description: | A JSON:API error response document containing an array of error objects. ErrorObject: type: object properties: id: description: A unique identifier for a specific instance of an error oneOf: - type: 'null' - type: string format: uuid description: > A unique identifier for this particular occurrence of the problem. links: description: Relevant links about the error oneOf: - type: 'null' - type: object properties: about: type: string format: uri description: > A link that leads to further details about this particular occurrence of the problem. additionalProperties: false status: type: string description: > The HTTP status code applicable to this problem, expressed as a string value. code: $ref: '#/components/schemas/ErrorCode' title: type: string description: > A short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization. detail: type: string description: > A human-readable explanation specific to this occurrence of the problem. Like `title`, this field's value can be localized. source: $ref: '#/components/schemas/ErrorSource' meta: description: | Optional structured metadata specific to the error code. For `cap-exceeded` this matches the `CapExceededMeta` schema; for `stale-version` it matches the `StaleVersionMeta` schema; for `queue-full` it matches the `QueueFullMeta` schema. oneOf: - type: 'null' - $ref: '#/components/schemas/CapExceededMeta' - $ref: '#/components/schemas/StaleVersionMeta' - $ref: '#/components/schemas/QueueFullMeta' - type: object additionalProperties: true additionalProperties: false required: [] description: > An error object provides additional information about problems encountered while performing an operation. Error objects MUST be returned as an array keyed by `errors` in the top level of a JSON:API document. ErrorCode: type: string enum: - bad-request - unauthorized - forbidden - not-found - conflict - payload-too-large - unprocessable-entity - unexpected-error - unsupported-extension - not-executable-shape - describe-failed - bundling-failed - sandbox-runtime-error - component-not-executable - execution-permission-denied - cap-exceeded - failed-dependency - stale-version - gone - service-unavailable - queue-full - invitation-org-managed - event-stream-capacity - chat-too-large - chat-awaiting-approval - approval-attempt-mismatch - approval-generation-stale - approval-attempt-conflict - method-not-allowed - mention-not-member - mention-no-access - mention-limit-exceeded description: > An application-specific error code, expressed as a string value. Error codes: - `bad-request`: Malformed request - `unauthorized`: Authentication required - `forbidden`: Permission denied - `not-found`: Resource not found - `conflict`: Resource conflict - `payload-too-large`: Request payload exceeds the allowed size - `unprocessable-entity`: Validation failed - `unexpected-error`: Internal server error - `unsupported-extension`: File extension not supported for execution - `not-executable-shape`: File structure not compatible with execution - `describe-failed`: Tool describe() method failed - `bundling-failed`: Code bundling failed - `sandbox-runtime-error`: Runtime execution error - `component-not-executable`: Component file requires render, not execute - `execution-permission-denied`: User lacks execute permission - `cap-exceeded`: Per-user usage cap exceeded; details in `meta` - `failed-dependency`: Required upstream prerequisite is unavailable - `stale-version`: Write rejected because the resource's head version no longer matches the caller's `expected_version`; details in `meta` - `gone`: Resource permanently removed or no longer accepting events - `service-unavailable`: A required backing service is unavailable or not configured - `queue-full`: The chat's queued-message backlog is at its per-chat depth cap; wait for the active turn to finish (which drains the queue), then retry - `invitation-org-managed`: The account is an org-managed workspace; invitations must go through the Zapier organization admin center - `event-stream-capacity`: Too many concurrent event streams for this user; close one or retry shortly. Not a usage cap - `chat-too-large`: The chat holds too many events for the requested operation to copy. Retrying cannot succeed - `chat-awaiting-approval`: The named message waits on a tool approval, so a copy of it cannot carry the tool's outcome. Answer the approval in the source chat first - `approval-attempt-mismatch`: The idempotency key was already accepted with a different decision or request body - `approval-generation-stale`: The request refers to a permission generation that is no longer current - `approval-attempt-conflict`: Another idempotency key already claimed this permission generation - `method-not-allowed`: The endpoint does not support this HTTP method - `mention-not-member`: A comment mentions a user who is not an active member of the item's account - `mention-no-access`: A comment mentions a user who cannot open the item. An owner of the item can share it with that user first - `mention-limit-exceeded`: A comment mentions more users than the per-comment cap allows ErrorSource: description: > Identifies the source of the error within the request payload, if relevant. oneOf: - type: 'null' - type: object properties: pointer: type: string description: > A JSON Pointer [RFC6901](https://tools.ietf.org/html/rfc6901) to the associated entity in the request document [e.g. `/data` for a primary data object, or `/data/attributes/title` for a specific attribute]. parameter: type: string description: | A string indicating which URI query parameter caused the error. header: type: string description: | A string indicating the header that caused the error. additionalProperties: false CapExceededMeta: type: object description: | Structured metadata returned in the 429 `cap-exceeded` error response. Identifies which usage cap was hit, current usage, the cap's nominal value (soft cap, not hard cap × grace), and when the bucket resets. required: - cap - used - cap_value - reset_at properties: cap: type: string enum: - messages_per_day - tool_calls_per_day - cost_per_day - cost_per_month - cost_burst - automation_runs_per_hour description: | Which cap was hit. Closed enum so clients can dispatch on this without a translation table. used: type: number description: | Counter or USD value at the moment of rejection. Integer for count caps, USD float for cost caps. cap_value: type: number description: | Soft cap value (the cap before the 10% grace buffer). For cost caps, in USD. reset_at: type: string format: date-time description: | When the bucket clears. Daily caps reset at the next UTC midnight, monthly at the first of the next UTC month, burst at the next 5-minute window boundary. additionalProperties: false StaleVersionMeta: type: object description: | Structured metadata returned in the 409 `stale-version` error response. Lets clients reconcile their cached view of a file against the server's current head version without re-fetching the full content first. required: - current_version - expected_version properties: current_version: type: integer description: | The resource's head version at the moment the write was rejected. Clients can re-read the resource at this version (or higher) to reconcile, then retry the write with an updated `expected_version`. expected_version: type: integer description: | The `expected_version` value the client supplied, echoed back so clients can detect duplicate or out-of-order failure handling. additionalProperties: false QueueFullMeta: type: object description: > Structured metadata returned in the 429 `queue-full` error response. Reports the chat's queued-message backlog at the moment of rejection and the per-chat depth cap it hit. Unlike `CapExceededMeta`, there is no `reset_at`: the limit is structural, not time-based — the backlog drains when the active turn finishes, so a retry is gated on chat state, not a clock. required: - queue_depth - limit properties: queue_depth: type: number description: > Number of `queued` messages the chat held at the moment of rejection. limit: type: number description: | The per-chat queued-message depth cap that was hit. additionalProperties: false securitySchemes: OAuth: type: oauth2 description: OAuth 2.0 authentication. flows: authorizationCode: authorizationUrl: https://zapier.com/oauth/authorize tokenUrl: https://zapier.com/oauth/token scopes: {} clientCredentials: tokenUrl: https://zapier.com/oauth/token scopes: {} ````