> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Mettre à jour la planification
> Mettre à jour une planification existante.
## Permissions
Nécessite un compte de service disposant de l’autorisation `ManageOrgSchedules` au niveau de l’organisation.
## Remarques
Tous les champs sont facultatifs. Seuls les champs fournis dans le corps de la requête seront mis à jour. Pour désactiver une planification, définissez `enabled` sur `false`.
Définir `playbook_id` sur `null` effacera l’association avec le playbook.
Vous pouvez modifier `schedule_type` entre `recurring` et `one_time`. Lorsque vous passez à `one_time`, renseignez `scheduled_at` avec une date et heure ISO 8601 ultérieure. Lorsque vous passez à `recurring`, renseignez `frequency` avec une expression cron valide.
## Identité d'exécution
Le paramètre `run_as_user_id` contrôle l'identité utilisateur sous laquelle la planification s'exécute. Lorsqu'une planification se déclenche, les sessions sont créées pour cet utilisateur : il reçoit les notifications et la session apparaît dans son historique.
* **Définir un utilisateur** : fournissez un ID utilisateur valide pour modifier l'identité d'exécution. 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`
* **Effacer (définir sur `null`)** : rétablit l'exécution de la planification sous le bot par défaut
* **Omettre le champ** : laisse l'identité d'exécution actuelle inchangée
## OpenAPI
````yaml fr/v3-openapi.json PATCH /v3/organizations/{org_id}/schedules/{schedule_id}
openapi: 3.1.0
info:
description: API Devin v3 avec authentification par utilisateur de service et RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3/organizations/{org_id}/schedules/{schedule_id}:
patch:
tags:
- schedules
summary: Mettre à jour la planification
description: Mettre à jour une planification existante.
operationId: >-
handle_update_schedule_v3_organizations__org_id__schedules__schedule_id__patch
parameters:
- description: "ID de la planification (préfixe\_: sched-)"
in: path
name: schedule_id
required: true
schema:
example: sched-abc123def456
title: Schedule Id
type: string
- description: "ID d’organisation (préfixe\_: org-)"
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleUpdateRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ScheduleResponse'
description: Réponse réussie
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Erreur de validation
components:
schemas:
ScheduleUpdateRequest:
properties:
agent:
anyOf:
- enum:
- devin
- data_analyst
type: string
- type: 'null'
title: Agent
bypass_approval:
anyOf:
- type: boolean
- type: 'null'
title: Bypass Approval
enabled:
anyOf:
- type: boolean
- type: 'null'
title: Enabled
frequency:
anyOf:
- type: string
- type: 'null'
title: Frequency
interval_count:
anyOf:
- type: integer
- type: 'null'
title: Interval Count
name:
anyOf:
- type: string
- type: 'null'
title: Name
notify_on:
anyOf:
- enum:
- always
- failure
- never
type: string
- type: 'null'
title: Notify On
platform:
anyOf:
- type: string
- type: 'null'
description: "Plateforme VM des sessions déclenchées par cette planification (p.\_ex. 'windows'). Lorsqu’elle est omise, la plateforme reste inchangée. La valeur doit correspondre à une plateforme configurée pour l’organisation (sans distinction entre majuscules et minuscules)\_; les valeurs inconnues sont rejetées avec une erreur 400 qui répertorie les libellés de plateforme disponibles."
title: Platform
playbook_id:
anyOf:
- type: string
- type: 'null'
title: Playbook Id
prompt:
anyOf:
- type: string
- type: 'null'
title: Prompt
run_as_user_id:
anyOf:
- type: string
- type: 'null'
description: >-
Définit l’ID utilisateur sous lequel cette planification
s’exécutera. Nécessite l’autorisation ImpersonateOrgSessions. La
définir sur `null` rétablit l’utilisateur bot par défaut. Si le
champ est omis, l’identité actuelle reste inchangée.
title: Run As User Id
schedule_type:
anyOf:
- enum:
- recurring
- one_time
type: string
- type: 'null'
title: Schedule Type
scheduled_at:
anyOf:
- format: date-time
type: string
- type: 'null'
title: Scheduled At
slack_channel_id:
anyOf:
- type: string
- type: 'null'
title: Slack Channel Id
slack_team_id:
anyOf:
- type: string
- type: 'null'
title: Slack Team Id
tags:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tags
target_devin_id:
anyOf:
- type: string
- type: 'null'
title: Target Devin Id
title: ScheduleUpdateRequest
type: object
ScheduleResponse:
properties:
agent:
enum:
- devin
- data_analyst
title: Agent
type: string
bypass_approval:
default: false
title: Bypass Approval
type: boolean
consecutive_failures:
title: Consecutive Failures
type: integer
created_at:
format: date-time
title: Created At
type: string
created_by:
anyOf:
- type: string
- type: 'null'
title: Created By
enabled:
title: Enabled
type: boolean
frequency:
anyOf:
- type: string
- type: 'null'
title: Frequency
interval_count:
default: 1
title: Interval Count
type: integer
last_edited_by:
anyOf:
- type: string
- type: 'null'
title: Last Edited By
last_error_at:
anyOf:
- format: date-time
type: string
- type: 'null'
title: Last Error At
last_error_message:
anyOf:
- type: string
- type: 'null'
title: Last Error Message
last_executed_at:
anyOf:
- format: date-time
type: string
- type: 'null'
title: Last Executed At
name:
title: Name
type: string
notify_on:
enum:
- always
- failure
- never
title: Notify On
type: string
org_id:
title: Org Id
type: string
platform:
anyOf:
- type: string
- type: 'null'
title: Platform
playbook:
anyOf:
- $ref: '#/components/schemas/PlaybookInfo'
- type: 'null'
prompt:
title: Prompt
type: string
schedule_type:
default: recurring
enum:
- recurring
- one_time
title: Schedule Type
type: string
scheduled_at:
anyOf:
- format: date-time
type: string
- type: 'null'
title: Scheduled At
scheduled_session_id:
title: Scheduled Session Id
type: string
slack_channel_id:
anyOf:
- type: string
- type: 'null'
title: Slack Channel Id
slack_team_id:
anyOf:
- type: string
- type: 'null'
title: Slack Team Id
tags:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Tags
target_devin_id:
anyOf:
- type: string
- type: 'null'
title: Target Devin Id
updated_at:
format: date-time
title: Updated At
type: string
required:
- scheduled_session_id
- org_id
- created_by
- name
- prompt
- playbook
- frequency
- enabled
- last_executed_at
- created_at
- updated_at
- last_error_at
- last_error_message
- consecutive_failures
- notify_on
- agent
title: ScheduleResponse
type: object
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
PlaybookInfo:
properties:
playbook_id:
title: Playbook Id
type: string
title:
anyOf:
- type: string
- type: 'null'
title: Title
required:
- playbook_id
- title
title: PlaybookInfo
type: object
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
bearerAuth:
description: "Identifiant d’utilisateur de service (préfixe\_: cog_)"
scheme: bearer
type: http
````