Vai al contenuto principale
PATCH
Aggiorna la pianificazione
Deprecato. Le pianificazioni sono state sostituite dalle automazioni. Questo endpoint continua a funzionare per le pianificazioni esistenti; le nuove attività pianificate dovrebbero essere create come automazione con un trigger schedule:recurring.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageOrgSchedules a livello di organizzazione.

Note

Tutti i campi sono facoltativi. Verranno aggiornati solo i campi forniti nel corpo della richiesta. Per disabilitare una pianificazione, imposta enabled su false. Impostare playbook_id su null rimuoverà il playbook associato. Puoi modificare schedule_type tra recurring e one_time. Quando lo imposti su one_time, fornisci scheduled_at con una data e ora futura nel formato ISO 8601. Quando lo imposti su recurring, fornisci frequency con una espressione cron valida.

Identità di esecuzione

Il parametro run_as_user_id controlla con quale identità utente viene eseguita la pianificazione. Quando una pianificazione viene attivata, le sessioni vengono create con questo utente: riceve le notifiche e la sessione appare nella sua cronologia.
  • Imposta un utente: Fornisci un ID utente valido per modificare l’identità di esecuzione. Questo richiede:
    1. L’utente di servizio deve avere l’autorizzazione ImpersonateOrgSessions
    2. L’utente di destinazione deve essere un membro dell’organizzazione
    3. L’utente di destinazione deve avere l’autorizzazione UseDevinSessions
  • Reimposta (imposta a null): Fa sì che la pianificazione venga nuovamente eseguita come utente bot predefinito
  • Ometti il campo: Lascia invariata l’identità di esecuzione corrente

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale utente di servizio (prefisso: cog_)

Parametri del percorso

schedule_id
string
obbligatorio

ID della pianificazione (prefisso: sched-)

Esempio:

"sched-abc123def456"

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json
name
string | null
prompt
string | null
playbook_id
string | null
skill_ref
SkillReference · object | null

Skill specifica con cui vengono eseguite le sessioni. Usare al posto di playbook_id per le nuove configurazioni.

frequency
string | null
interval_count
integer | null
schedule_type
enum<string> | null
Opzioni disponibili:
recurring,
one_time
scheduled_at
string<date-time> | null
enabled
boolean | null
notify_on
enum<string> | null
Opzioni disponibili:
always,
failure,
never
agent
enum<string> | null
Opzioni disponibili:
devin,
data_analyst
bypass_approval
boolean | null
run_as_user_id
string | null

Imposta l'ID utente con cui verrà eseguita questa pianificazione. Richiede l'autorizzazione ImpersonateOrgSessions. Se impostato su null, viene ripristinato l'utente bot predefinito. Se il campo viene omesso, l'identità corrente rimane invariata.

slack_channel_id
string | null
slack_team_id
string | null
tags
string[] | null
target_devin_id
string | null
platform
string | null

Piattaforma VM per le sessioni generate da questa pianificazione (ad es. 'windows'). Se omessa, la piattaforma rimane invariata. 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 di piattaforma disponibili.

Risposta

Risposta di successo

scheduled_session_id
string
obbligatorio
org_id
string
obbligatorio
created_by
string | null
obbligatorio
name
string
obbligatorio
prompt
string
obbligatorio
playbook
PlaybookInfo · object | null
obbligatorio
frequency
string | null
obbligatorio
enabled
boolean
obbligatorio
last_executed_at
string<date-time> | null
obbligatorio
created_at
string<date-time>
obbligatorio
updated_at
string<date-time>
obbligatorio
last_error_at
string<date-time> | null
obbligatorio
last_error_message
string | null
obbligatorio
consecutive_failures
integer
obbligatorio
notify_on
enum<string>
obbligatorio
Opzioni disponibili:
always,
failure,
never
agent
enum<string>
obbligatorio
Opzioni disponibili:
devin,
data_analyst
last_edited_by
string | null
skill_ref
SkillReference · object | null

Skill specifica con cui vengono eseguite le sessioni. Usare al posto di playbook_id per le nuove configurazioni.

interval_count
integer
predefinito:1
schedule_type
enum<string>
predefinito:recurring
Opzioni disponibili:
recurring,
one_time
scheduled_at
string<date-time> | null
bypass_approval
boolean
predefinito:false
slack_channel_id
string | null
slack_team_id
string | null
tags
string[] | null
target_devin_id
string | null
platform
string | null