Crea pianificazione

Crea una nuova sessione pianificata.

POST /v3/organizations/{org_id}/schedules

Crea pianificazione

cURL

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>"
}
'

200

{
  "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>"
}

​

Autorizzazioni

Richiede un utente di servizio con l’autorizzazione ManageOrgSchedules a livello di organizzazione.

​

Tipo di pianificazione

Il campo schedule_type determina se la pianificazione è ricorrente o una tantum:

• recurring (valore predefinito) — Richiede il campo frequency con un’espressione cron
• one_time — Richiede il campo scheduled_at con una data e ora future in formato ISO 8601

​

Frequenza

Per le pianificazioni ricorrenti, il campo frequency accetta un’espressione cron standard (ad esempio 0 9 * * 1-5 per i giorni feriali alle 9:00 UTC).

​

Programmato alle

Per le pianificazioni singole, il campo scheduled_at accetta una data e ora in formato ISO 8601 con fuso orario (ad esempio 2026-03-01T09:00:00Z). La data e l’ora devono essere nel futuro. Dopo l’esecuzione, la pianificazione viene disabilitata automaticamente.

​

Tipi di agenti

Agente	Descrizione
devin	Agente Devin standard (predefinito)
data_analyst	Agente analista dati
advanced	Agente avanzato

​

Impersonificazione utente

Il parametro create_as_user_id consente di creare una pianificazione per conto di un altro utente. Ciò richiede che:

1. L’utente di servizio disponga dell’autorizzazione ImpersonateOrgSessions
2. L’utente di destinazione sia membro dell’organizzazione
3. L’utente di destinazione disponga dell’autorizzazione UseDevinSessions

Autorizzazioni

Authorization · string · header · obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Corpo

application/json

name · string · obbligatorio

prompt · string · obbligatorio

agent · enum<string> · predefinito: devin

Opzioni disponibili: devin, data_analyst

bypass_approval · boolean · predefinito: false

create_as_user_id · string | null

frequency · string | null

interval_count · integer · predefinito: 1

notify_on · enum<string> · predefinito: failure

Opzioni disponibili: always, failure, never

platform · string | null

Piattaforma VM per le sessioni generate da questa pianificazione (ad es. 'windows'). Se omessa, le sessioni usano la piattaforma predefinita dell'org al momento dell'attivazione. Il valore deve corrispondere a una piattaforma configurata per l'organizzazione (senza distinzione tra maiuscole e minuscole); i valori sconosciuti vengono rifiutati con un 400 che elenca le etichette delle piattaforme disponibili.

playbook_id · string | null

schedule_type · enum<string> · predefinito: recurring

Opzioni disponibili: 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

Risposta

200

application/json

Risposta positiva

agent · enum<string> · obbligatorio

Opzioni disponibili: devin, data_analyst

consecutive_failures · integer · obbligatorio

created_at · string<date-time> · obbligatorio

created_by · string | null · obbligatorio

enabled · boolean · obbligatorio

frequency · string | null · obbligatorio

last_error_at · string<date-time> | null · obbligatorio

last_error_message · string | null · obbligatorio

last_executed_at · string<date-time> | null · obbligatorio

name · string · obbligatorio

notify_on · enum<string> · obbligatorio

Opzioni disponibili: always, failure, never

org_id · string · obbligatorio

playbook · PlaybookInfo · object · obbligatorio

Show child attributes

prompt · string · obbligatorio

scheduled_session_id · string · obbligatorio

updated_at · string<date-time> · obbligatorio

bypass_approval · boolean · predefinito: false

interval_count · integer · predefinito: 1

last_edited_by · string | null

platform · string | null

schedule_type · enum<string> · predefinito: recurring

Opzioni disponibili: 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