Passer au contenu principal
POST
/
v3
/
organizations
/
{org_id}
/
schedules
Créer un planning
curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "agent": "devin",
  "bypass_approval": false,
  "create_as_user_id": "<string>",
  "frequency": "<string>",
  "interval_count": 1,
  "notify_on": "failure",
  "platform": "<string>",
  "playbook_id": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}
'
{
  "consecutive_failures": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "enabled": true,
  "frequency": "<string>",
  "last_error_at": "2023-11-07T05:31:56Z",
  "last_error_message": "<string>",
  "last_executed_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "org_id": "<string>",
  "playbook": {
    "playbook_id": "<string>",
    "title": "<string>"
  },
  "prompt": "<string>",
  "scheduled_session_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "bypass_approval": false,
  "interval_count": 1,
  "last_edited_by": "<string>",
  "platform": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}

​
Autorisations

Nécessite un compte de service disposant de l’autorisation ManageOrgSchedules au niveau de l’organisation.

​
Type de planification

Le champ schedule_type indique si la planification est récurrente ou ponctuelle :
  • recurring (par défaut) — Nécessite le champ frequency avec une expression cron
  • one_time — Nécessite le champ scheduled_at avec une date et heure au format ISO 8601 dans le futur

​
Fréquence

Pour les planifications récurrentes, le champ frequency accepte une expression cron au format standard (par exemple, 0 9 * * 1-5 pour les jours ouvrés à 9 h UTC).

​
Date de planification

Pour les programmations uniques, le champ scheduled_at accepte une date et une heure au format ISO 8601 avec fuseau horaire (par exemple, 2026-03-01T09:00:00Z). La date et l’heure doivent être postérieures au moment présent. Après son exécution, la programmation est automatiquement désactivée.

​
Types d’agents

AgentDescription
devinAgent Devin standard (par défaut)
data_analystAgent d’analyse de données
advancedAgent avancé

​
Usurpation d’identité d’utilisateur

Le paramètre create_as_user_id permet de créer une planification pour le compte d’un autre utilisateur. Cela nécessite :
  1. Le compte de service doit disposer de l’autorisation ImpersonateOrgSessions
  2. L’utilisateur cible doit être membre de l’organisation
  3. L’utilisateur cible doit disposer de l’autorisation UseDevinSessions

Autorisations

​
Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

​
org_id
string
requis

ID de l’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

application/json
​
name
string
requis
​
prompt
string
requis
​
agent
enum<string>
défaut:devin
Options disponibles:
devin,
data_analyst
​
bypass_approval
boolean
défaut:false
​
create_as_user_id
string | null
​
frequency
string | null
​
interval_count
integer
défaut:1
​
notify_on
enum<string>
défaut:failure
Options disponibles:
always,
failure,
never
​
platform
string | null

Plateforme de VM pour les sessions générées par cette planification (p. ex. 'windows'). Si elle est omise, les sessions utilisent la plateforme par défaut de l'organisation au moment du déclenchement. La valeur doit correspondre à une plateforme configurée pour l'organisation (sans distinction de casse) ; les valeurs inconnues sont rejetées avec une erreur 400 qui liste les libellés de plateforme disponibles.

​
playbook_id
string | null
​
schedule_type
enum<string>
défaut:recurring
Options disponibles:
recurring,
one_time
​
scheduled_at
string<date-time> | null
​
slack_channel_id
string | null
​
slack_team_id
string | null
​
tags
string[] | null
​
target_devin_id
string | null

Réponse

Réponse réussie

​
agent
enum<string>
requis
Options disponibles:
devin,
data_analyst
​
consecutive_failures
integer
requis
​
created_at
string<date-time>
requis
​
created_by
string | null
requis
​
enabled
boolean
requis
​
frequency
string | null
requis
​
last_error_at
string<date-time> | null
requis
​
last_error_message
string | null
requis
​
last_executed_at
string<date-time> | null
requis
​
name
string
requis
​
notify_on
enum<string>
requis
Options disponibles:
always,
failure,
never
​
org_id
string
requis
​
playbook
PlaybookInfo · object
requis
​
prompt
string
requis
​
scheduled_session_id
string
requis
​
updated_at
string<date-time>
requis
​
bypass_approval
boolean
défaut:false
​
interval_count
integer
défaut:1
​
last_edited_by
string | null
​
platform
string | null
​
schedule_type
enum<string>
défaut:recurring
Options disponibles:
recurring,
one_time
​
scheduled_at
string<date-time> | null
​
slack_channel_id
string | null
​
slack_team_id
string | null
​
tags
string[] | null
​
target_devin_id
string | null