Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Warp

Warp schedules API

Operations for creating and managing scheduled agents

Documentation Provider Profile APIs.io OpenAPI GitHub

Warp schedules API is one of 5 APIs that Warp publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include schedules. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 3 JSON Schemas.

This API exposes 7 operations across 4 paths, and defines 23 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://app.warp.dev/api/v1.

7 operations 4 paths 23 schemas 1 DELETE2 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://app.warp.dev/api/v1
Authentication
HTTP Bearer
Contact
Warp Support
License
Proprietary
Resource Areas
1

Authentication & Security 1

Warp schedules API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth).

  • bearerAuth — Authentication via a Warp API key.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 2 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

schedules 7

Operations for creating and managing scheduled agents

POST
/agent/schedules
Create a scheduled agent
createScheduledAgent body → 201400401403
GET
/agent/schedules
List scheduled agents
listScheduledAgents → 200401500
GET
/agent/schedules/{scheduleId}
Get scheduled agent details
getScheduledAgent 1 param → 200400401403404
PUT
/agent/schedules/{scheduleId}
Update a scheduled agent
updateScheduledAgent 1 param body → 200400401403404
DELETE
/agent/schedules/{scheduleId}
Delete a scheduled agent
deleteScheduledAgent 1 param → 200401403404500
POST
/agent/schedules/{scheduleId}/pause
Pause a scheduled agent
pauseScheduledAgent 1 param → 200401403404500
POST
/agent/schedules/{scheduleId}/resume
Resume a scheduled agent
resumeScheduledAgent 1 param → 200401403404500

Schemas 23

The contract defines 23 schemas that model the data the API accepts and returns. The most detailed are ScheduledAgentItem (15 properties), AmbientAgentConfig (15 properties), CreateScheduledAgentRequest (8 properties), Error (8 properties). Each schema is shown below with its type and property counts.

SessionSharingConfig
object
Configures sharing behavior for the run's shared session. When set, the worker emits --share public: and the bundled Warp client applies an anyone-with-link AC…
1 property
Harness
object
Specifies which execution harness to use for the agent run. Default (nil/empty) uses Warp's built-in harness.
1 property
Scope
object
Ownership scope for a resource (team or personal)
2 properties 1 required
RunCreatorInfo
object
5 properties
AwsProviderConfig
object
AWS IAM role assumption settings
1 property 1 required
DeleteScheduledAgentResponse
object
1 property 1 required
ListScheduledAgentsResponse
object
1 property 1 required
ScheduledAgentHistoryItem
object
Scheduler-derived history metadata for a scheduled agent
2 properties
CloudEnvironmentConfig
object
Configuration for a cloud environment used by scheduled agents
6 properties
MemoryStoreRef
object
Reference to a memory store to attach to an agent.
3 properties 3 required
ProvidersConfig
object
Optional cloud provider configurations for automatic auth
2 properties
ScheduledAgentItem
object
15 properties 7 required
GcpProviderConfig
object
GCP Workload Identity Federation settings
4 properties 3 required
AmbientAgentConfig
object
Configuration for a cloud agent run
15 properties
GitHubRepo
object
2 properties 2 required
AwsInferenceProviderConfig
object
Configures AWS Bedrock as the LLM inference provider for this agent or run.
3 properties
MCPServerConfig
object
Configuration for an MCP server. Must have exactly one of: warpid, command, or url.
6 properties
AgentRunMode
string
Query mode for an agent run. - normal: Standard user query (default). - plan: Planning Mode. The agent researches and creates a plan, then waits for approval b…
InferenceProvidersConfig
object
Inference provider settings used for LLM calls.
1 property
CreateScheduledAgentRequest
object
Request body for creating a new scheduled agent. Either prompt or agentconfig.skillspec or agentconfig.skills is required.
8 properties 2 required
HarnessAuthSecrets
object
Authentication secrets for third-party harnesses. Only the secret for the harness specified gets injected into the environment.
2 properties
UpdateScheduledAgentRequest
object
Request body for updating a scheduled agent. Either prompt or agentconfig.skillspec or agentconfig.skills is required.
7 properties 3 required
Error
object
Error response following RFC 7807 (Problem Details for HTTP APIs). Includes backward-compatible extension members. The response uses the application/problem+js…
8 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

warp-schedules-api-openapi.yml Raw ↑

Other APIs Warp publishes across the network.

Warp Enterprise Analytics API
AE Profile APIs.io
Warp Oz CLI
AE Profile APIs.io
Warp agent API
AE Profile APIs.io
Warp harness-support API
AE Profile APIs.io
#schedules
← Back to W APIs
API Details
ID
warp:warp-schedules-api
Base URL
https://app.warp.dev/api/v1
Docs
https://docs.warp.dev/reference/api-and-sdk/
Provider
Warp
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network