curl --request PATCH \
  --url https://api.zapier.com/agentic-management/v0/{workflow_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "modes": [
    "heal",
    "harden"
  ]
}
'

{
  "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "modes": [
    "heal"
  ],
  "auto_approve": true
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

Automations

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.

PATCH

agentic-management

{workflow_id}

curl --request PATCH \
  --url https://api.zapier.com/agentic-management/v0/{workflow_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "modes": [
    "heal",
    "harden"
  ]
}
'

{
  "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "modes": [
    "heal"
  ],
  "auto_approve": true
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

{
  "errors": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "links": {
        "about": "<string>"
      },
      "status": "<string>",
      "code": "bad-request",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>",
        "parameter": "<string>",
        "header": "<string>"
      },
      "meta": {
        "cap": "messages_per_day",
        "used": 123,
        "cap_value": 123,
        "reset_at": "2023-11-07T05:31:56Z"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

OAuth 2.0 authentication.

FlowAuthorization Code

Authorization URL: https://zapier.com/oauth/authorize
Token URL: https://zapier.com/oauth/token

FlowClient Credentials

Token URL: https://zapier.com/oauth/token

Path Parameters

workflow_id

string<uuid>

required

Workflow ID to update.

Body

application/json

modes

enum<string>[]

Agentic modes to activate. Replaces the current set. Omit to leave the active modes unchanged.

Minimum array length: 1

Available options:

heal,

expand,

harden

auto_approve

boolean

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.

Response

workflow_id

string<uuid>

required

The workflow whose config was updated.

modes

enum<string>[]

required

Active agentic modes after the update.

Available options:

heal,

expand,

harden

auto_approve

boolean

required

Auto-approve state after the update.

Last modified on October 7, 2026

Trigger Inbox API

Actions API

Workflow API

Connections API

Agentic Management

Update Agentic Management config for a workflow

Authorizations

Path Parameters

Body

Response