Warp
API integration

list_all_warp_agents

List available Warp agents (skills) that can be used to run tasks, discovered from accessible environments or a specific repository. Returns each agent's name and a variants array; each variant includes id, description, base_prompt, source (owner, name, skill_path, worker_host), environments, last_run_timestamp, and error.

list_all_warp_agent_connected_self_hosted_workers

List currently connected self-hosted workers for the authenticated team in Warp. Returns: worker_host, connection_count, connected_at, last_seen_at. Worker presence is derived from websocket heartbeats and may be briefly stale.

list_all_warp_run_transcripts

Retrieve the raw conversation transcript for a warp agent run. The API issues a 302 redirect to a time-limited download URL containing the transcript content; no structured JSON body is returned on success. Required: run_id.

create_a_warp_agent_run

Spawn a Warp cloud agent run with a prompt and optional configuration. The agent is queued for execution and assigned a unique run ID. Returns: run_id, task_id, state, at_capacity. Required: prompt.

list_all_warp_agent_runs

List Warp agent runs with optional filtering by state, creator, model, date range, skill, and more. Results default to sort_by=updated_at and sort_order=desc. Returns: run_id, task_id, title, state, execution_location, prompt, created_at, updated_at, run_time, started_at, status_message, source, schedule, session_id, session_link, trigger_url, creator, executor, request_usage, agent_config,…

get_single_warp_agent_run_by_id

Get detailed information about a specific Warp agent run by id, including the full prompt, session link, and resolved agent configuration. Returns: run_id, task_id, title, state, execution_location, prompt, created_at, updated_at, run_time, started_at, status_message, source, schedule, session_id, session_link, trigger_url, creator, executor, request_usage, agent_config, conversation_id,…

warp_agent_runs_cancel

Cancel a Warp agent run that is queued or in progress. Returns the run_id string of the cancelled run. Required: run_id. Cannot cancel runs already in a terminal state (SUCCEEDED, FAILED, ERROR, BLOCKED, CANCELLED); PENDING-state runs return 409.

list_all_warp_run_timelines

List chronological setup and lifecycle timeline events for a warp agent run. Returns an events array where each item includes event_uuid, run_id, execution_id, event_type, occurred_at, and payload. Required: run_id.

list_all_warp_run_conversations

Get normalized run conversation in Warp by id. Returns conversation_id, steps with descriptions, summaries, timestamps, and nested messages showing user and system interactions.

create_a_warp_run_followup

Submit a follow-up message to an existing warp agent run. The server transparently routes the message based on the run's current state (queued, actively running, or ended). Returns an empty 200 response on success. Required: run_id.

get_single_warp_agent_conversation_by_id

Get a normalized conversation in Warp by id. Returns conversation_id, steps including step descriptions, timestamps, and messages with their content.

list_all_warp_agent_schedules

List all scheduled agents accessible to the authenticated user in Warp, sorted alphabetically by name. Returns: id, name, cron_schedule, enabled, prompt, last_spawn_error, agent_config, agent_uid, environment, created_at, updated_at, created_by, updated_by, history, scope.

create_a_warp_agent_schedule

Create a new scheduled agent in Warp that runs automatically on a cron expression. Returns the created agent including id, name, cron_schedule, enabled, prompt, agent_config, agent_uid, created_at, history, and scope. Required: name, cron_schedule.

get_single_warp_agent_schedule_by_id

Get a scheduled agent by id in Warp, including its full configuration, run history, and next scheduled execution time. Returns: id, name, cron_schedule, enabled, prompt, last_spawn_error, agent_config, agent_uid, environment, created_at, updated_at, created_by, updated_by, history, scope. Required: id.

update_a_warp_agent_schedule_by_id

Update an existing scheduled agent in Warp. Returns the updated agent including id, name, cron_schedule, enabled, prompt, agent_config, agent_uid, created_at, history, and scope. Required: id, name, cron_schedule, enabled.

delete_a_warp_agent_schedule_by_id

Delete a scheduled agent by id in Warp, stopping all future scheduled runs. Returns a 200 response on success. Required: id.

warp_agent_schedules_pause

Pause a scheduled agent in Warp, preventing it from running until resumed. Returns the updated schedule object including id, name, cron_schedule, enabled, prompt, agent_config, agent_uid, created_at, and updated_at. Required: schedule_id.

warp_agent_schedules_resume

Resume a paused scheduled agent in Warp so it begins running again according to its cron schedule. Returns the updated schedule object including id, name, cron_schedule, enabled, prompt, agent_config, agent_uid, created_at, and updated_at. Required: schedule_id.

list_all_warp_agent_environments

List cloud environments accessible to the authenticated principal in warp, including environments the caller owns, has been granted guest access to, or has accessed via link sharing. Returns: uid, config, last_updated, last_task_run_timestamp, last_task_created, setup_failed, scope, creator, last_editor.

list_all_warp_agent_models

List LLM models available to the authenticated user in Warp for agent runs. Returns per-model fields including id, display_name, provider, vision_supported, description, reasoning_level, and disable_reason (when the model is unavailable).

get_single_warp_agent_artifact_by_id

Get a single Warp artifact by id. For downloadable file-like artifacts returns a time-limited signed download URL; for plan artifacts returns the current content inline. Returns: artifact_uid, artifact_type, created_at, data. Required: id.

list_all_warp_harness_support_transcripts

Download the raw third-party harness transcript for the current task's conversation in Warp. Returns a 307 redirect to a signed download URL for the raw transcript file (e.g., claude_code.json). Only supported for non-Oz harness conversations; must be called from within a cloud agent execution environment that has an associated conversation.

list_all_warp_agent_identities

List all warp agent identities for the caller's team. Returns each agent's uid, name, available, description, prompt, environment_id, created_at, updated_at, base_model, skills, secrets, memory_stores, base_harness, inference_providers, and harness_auth_secrets.

create_a_warp_agent_identity

Create a new warp agent identity for the caller's team. Returns the created agent object including uid, name, available, created_at, updated_at, description, prompt, environment_id, base_model, secrets, skills, memory_stores, base_harness, inference_providers, and harness_auth_secrets. Required: name.

update_a_warp_agent_identity_by_id

Update an existing warp agent identity by id. Returns the updated agent object including uid, name, available, created_at, updated_at, description, prompt, environment_id, base_model, secrets, skills, memory_stores, base_harness, inference_providers, and harness_auth_secrets. Required: id.

delete_a_warp_agent_identity_by_id

Delete a warp agent identity by id. All API keys associated with the agent are deleted atomically. Returns an empty 204 response on success. Required: id.

get_single_warp_agent_identity_by_id

Retrieve a single Warp agent identity by id. Returns the full agent object including uid, name, available flag, created_at, updated_at, secrets, skills, memory_stores, inference_providers, base_model, base_harness, harness_auth_secrets, description, prompt, and environment_id. Required: id.