v1

latestOpenAPI 3.1.02026-07-26269227514.8 KB

schedules

Create schedule

Create a new scheduled session.

post/v3/organizations/{org_id}/schedules

Path parameters

org_idstring required

Example:org-abc123def456

Organization ID (prefix: org-)

Request body

agent'devin' | 'data_analyst'

bypass_approvalboolean

create_as_user_idstring nullable

frequencystring nullable

interval_countinteger

namestring required

notify_on'always' | 'failure' | 'never'

platformstring nullable

VM platform for sessions spawned by this schedule (e.g. 'windows'). When omitted, sessions fall back to the org's default platform at trigger time. Value must match a platform configured for the organization (case-insensitive); unknown values are rejected with a 400 that lists the available platform labels.

playbook_idstring nullable

promptstring required

schedule_type'recurring' | 'one_time'

scheduled_atstring date-time nullable

slack_channel_idstring nullable

slack_team_idstring nullable

tagsstring[] nullable

target_devin_idstring nullable

Response

Successful Response

agent'devin' | 'data_analyst' required

bypass_approvalboolean

consecutive_failuresinteger required

created_atstring date-time required

created_bystring nullable required

enabledboolean required

frequencystring nullable required

interval_countinteger

last_edited_bystring nullable

last_error_atstring date-time nullable required

last_error_messagestring nullable required

last_executed_atstring date-time nullable required