Sign in
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
namestring required
notify_on'always' | 'failure' | 'never' required
org_idstring required
platformstring nullable
promptstring required
schedule_type'recurring' | 'one_time'
scheduled_atstring date-time nullable
scheduled_session_idstring required
slack_channel_idstring nullable
slack_team_idstring nullable
tagsstring[] nullable
target_devin_idstring nullable
updated_atstring date-time required

Changes

No recorded changes to this endpoint across all 1 revision of this API.