Vai al contenuto principale
PUT
/
chrono
/
schedules
/
{scheduleId}
Aggiorna una programmazione
curl --request PUT \
  --url https://api.altostrat.io/chrono/schedules/{scheduleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Finestra Manutenzione Weekend",
  "timezone": "America/New_York",
  "hours": [
    {
      "day": "saturday",
      "start": "22:00",
      "end": "23:59"
    }
  ],
  "metadata": [
    {
      "key": "rif_ticket",
      "value": "JIRA-456"
    }
  ]
}'
{
  "id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "name": "Policy Orario di Lavoro",
  "timezone": "Australia/Sydney",
  "active": true,
  "updated_at": "2025-10-29T01:43:31Z",
  "created_at": "2025-10-29T01:43:31Z",
  "hours": [
    {
      "day": "monday",
      "start": "09:00",
      "end": "17:00"
    }
  ],
  "metadata": [
    {
      "key": "policy_id",
      "value": "pol_12345"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Inserisci la tua chiave API nel formato: Bearer {key}

Path Parameters

​
scheduleId
string<uuid>
required

L'identificatore univoco (UUID) della programmazione da aggiornare.

Example:

"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

Body

application/json

I dettagli della programmazione da aggiornare.

Il corpo della richiesta per la creazione o l'aggiornamento di una programmazione.

​
name
string
required

Il nome della programmazione. Deve essere unico all'interno del tuo workspace.

Maximum length: 200
Example:

"Finestra Manutenzione Weekend"

​
hours
object[]
required

Un array di oggetti fascia oraria. Questo array sostituirà completamente eventuali fasce orarie esistenti durante un aggiornamento.

Maximum length: 50
​
timezone
string

Un nome dal database dei fusi orari IANA, es. America/New_York o UTC. Se non fornito, verrà utilizzato il valore predefinito del workspace.

Example:

"America/New_York"

​
metadata
object[]

Un array di coppie chiave-valore. In fase di aggiornamento, fornire una chiave con valore null per eliminarla. Nuove chiavi verranno aggiunte e le chiavi esistenti verranno aggiornate.

Maximum length: 50

Response

La programmazione è stata aggiornata con successo.

Rappresenta un oggetto programmazione che definisce quando una policy o una configurazione è attiva.

​
id
string<uuid>

L'identificatore univoco per la programmazione.

Example:

"9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"

​
name
string

Un nome leggibile per la programmazione.

Example:

"Policy Orario di Lavoro"

​
timezone
string

L'identificatore di fuso orario IANA in cui opera questa programmazione. Tutti gli orari di start e end sono relativi a questo fuso orario.

Example:

"Australia/Sydney"

​
active
boolean

Un flag di sola lettura che indica se la programmazione si trova attualmente in una fascia oraria attiva. Questo valore è calcolato dal sistema.

Example:

true

​
updated_at
string<date-time>

La data e ora dell'ultimo aggiornamento della programmazione.

Example:

"2025-10-29T01:43:31Z"

​
created_at
string<date-time>

La data e ora di creazione della programmazione.

Example:

"2025-10-29T01:43:31Z"

​
hours
object[]

Un elenco di fasce orarie che definiscono i periodi attivi per questa programmazione.

​
metadata
object[]

Un elenco di coppie chiave-valore che possono essere utilizzate per memorizzare informazioni aggiuntive sulla programmazione.