Authentication: API key. See Magic Link for the runtime auth flow.
Sample use cases
- Start a cloud agent run that fixes the failing test in
api/handlers_test.go - List the scheduled agents in the team and when each runs next
- Fetch the artifacts produced by the last agent run
Available Tools
Cancel an in-flight agent run by id. Only runs whose type is cancellable and that are not already in a terminal state…
Create a new agent identity. Requires a name. Use list_environments for environment_id, list_models for base_model, l…
Start a new agent run from a prompt (or a skill spec). Returns the new run_id and initial state. Use list_agent_skill…
Create a scheduled agent that triggers runs on a cron schedule. Requires name and cron_schedule. Use list_agents for…
Delete an agent identity permanently by uid. The default agent cannot be deleted. Use list_agents to find uids.
Delete a scheduled agent permanently by id. Use list_scheduled_agents to find ids.
Get a signed URL to download an artifact’s file contents by uid. The API responds with a 302 redirect to a time-limit…
Get full detail for a single agent identity by uid. Use list_agents to find uids.
Get metadata for a run artifact by uid (type, filename, mime type, size). Artifact uids come from a run’s artifacts f…
Get full detail for a single agent run by id, including state, prompt, creator, timing, and artifacts. Use list_runs…
Get a signed URL to download the full transcript of a run. Use list_runs to find run ids. The API responds with a 302…
Get full detail for a single scheduled agent by id. Use list_scheduled_agents to find ids.
List discoverable agent skills from the /agent catalog and their variants (skill specs). Use the returned variant ids…
List agent identities for the team. Agent identities are the execution principals a run or schedule can run as. Use g…
List self-hosted worker hosts currently connected to the team, with connection counts and heartbeat timestamps. Use t…
List the cloud environments available for agent runs. Use the returned environment uids for environment_id on create_…
List the LLM models available for agent runs and the team’s default model id. Use the returned model ids for base_mod…
List agent runs with optional server-side filters (state, name, q, creator, model_id, source, execution_location, sch…
List all scheduled agents for the team, including their cron schedule and enabled state. Use get_scheduled_agent for…
Pause a scheduled agent by id so it stops triggering runs. Use resume_scheduled_agent to re-enable it. Use list_sched…
Resume a paused scheduled agent by id so it triggers runs again. Use pause_scheduled_agent to disable it. Use list_sc…
Update an agent identity by uid. Only the fields you pass are changed (partial update). Use list_agents to find uids…
Update a scheduled agent by id. This is a full replace (PUT): name, cron_schedule, and enabled are all required. Use…