Use the Agentic Workers Public API

What the Public API Is For

Use the public API when a trusted internal tool, integration, or automation runner needs structured access to the Agentic Workers organization that owns your main agent. It is versioned at /api/v1 and covers agents, memories, tools, prompt templates, platform scheduled jobs, integrations, and hosted-agent administration.

Start with a read-only request. Confirm the returned organization and target resource before you approve a write, command, schedule execution, gateway restart, or deletion.

Create and Protect an Organization Token

Make a Safe First Request

A read-only API request using environment variables rather than a pasted tokensh

export AGW_API_BASE_URL="https://www.agenticworkers.com/api/v1"
export AGW_API_TOKEN="<organization-operator-token>"

curl --fail-with-body \
  --header "Authorization: Bearer $AGW_API_TOKEN" \
  --header "Accept: application/json" \
  "$AGW_API_BASE_URL/agents?limit=20"

Use the OpenAPI Contract

Fetch the public OpenAPI document without sending a tokensh

curl --fail-with-body https://www.agenticworkers.com/api/v1/openapi.json

Choose the Right Scheduling Surface

Platform scheduled jobs are workspace automations attached to a platform agent and prompt template. Hosted routines live inside one hosted agent’s box. They are not interchangeable, so use the route family and target name to confirm which schedule you are changing.

A hosted main agent can be cloned through the API. Cloning copies the agent configuration and can queue a separate hosted environment clone. Treat that as a write operation, then inspect the new hosted agent’s status before using it for live work.

Retries and Troubleshooting

The current API does not publish an idempotency-key contract. If a state-changing call times out, stop and inspect the agent, job, trace, or hosted-agent state before retrying; repeating the request may duplicate work.

For an unauthorized response, verify that the token belongs to the intended organization and has not been revoked. For a validation error, correct the reported field instead of retrying unchanged. For an owner-only operation, use the organization owner’s approved credential.