List agent automations

list_agent_automations

Lists the agent automations on a site, with whether each is on and how its last run went.

POST /v1/list_agent_automationsScopeconfig:readRead only

Each automation comes back with its id, name, instruction, schedule, whether it is on, whether a run is going now, when it next runs, how its last run went, and why it switched off if it did. owner names the person who set it up and gets its reports, and ownedByYou says whether that is the person calling. lockedByModulify is true when Modulify switched it off. Use the id with the other agent automation tools. See Agents.

Request

Call it with a POST to https://api.modulify.ai/v1/list_agent_automations, sending the inputs below as a JSON object. The token needs the config:read scope.

It only reads and changes nothing, so retrying it is safe.

curl -X POST https://api.modulify.ai/v1/list_agent_automations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'

Over MCP, the same method is the list_agent_automations tool.

Inputs

Input Type Required Description
projectId string Yes The site id.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.