{"openapi":"3.1.0","info":{"title":"Pathly API","version":"1.0.0","description":"API pubblica di Pathly. Autenticazione con chiave Bearer ad ambiti nominati. Ogni scrittura viene registrata nell’audit dell’organizzazione."},"servers":[{"url":"https://api.pathlyhq.com"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Chiave API dell’organizzazione, prefisso `sp_`. Creata in Impostazioni, poi Chiavi API, da un account proprietario o amministratore."}},"schemas":{"Error":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/scenarios":{"get":{"operationId":"get_v1_scenarios","summary":"Elencare gli scenari","description":"Il percorso di uno scenario browser non viene restituito: contiene credenziali di accesso. `scenarioFingerprint` cambia non appena viene modificato, il che basta a rilevare una deriva.","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Dimensione della pagina, 100 per impostazione predefinita."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Valore `nextCursor` della risposta precedente. Assente nell’ultima pagina."},{"name":"space_id","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Solo gli scenari di questo Spazio. Una chiave limitata a uno Spazio vede solo il proprio."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"post_v1_scenarios","summary":"Creare uno scenario","description":"`type: http` richiede `url` o `httpChain`. `type: browser` richiede `scenario`. `enabled: false` prepara uno scenario senza far scattare alcun avviso. Ripetibile con `Idempotency-Key`.","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120},"type":{"type":"string","enum":["http","browser"],"default":"http"},"url":{"type":"string","format":"uri","description":"Obbligatoria per un controllo HTTP."},"intervalSec":{"type":"integer","minimum":0,"maximum":2592000,"description":"0 = nessuna pianificazione."},"method":{"type":"string","enum":["GET","HEAD"],"default":"GET"},"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"maxLatencyMs":{"type":"integer","minimum":100,"maximum":600000},"expectText":{"type":"string","maxLength":500},"regions":{"type":"array","items":{"type":"string"},"maxItems":8},"scenario":{"type":"object","description":"Albero del percorso: elenco di passaggi (`goto`, `click`, `fill`, `assert_text`…) e, per una catena HTTP, `httpChain`. Veda la documentazione degli scenari.","additionalProperties":true,"properties":{"steps":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":10},"folder":{"type":"string","maxLength":60},"severity":{"type":"string","enum":["critical","major","minor"]},"runbook":{"type":"string","maxLength":2000},"cron":{"type":"string","maxLength":120,"description":"5 campi, ad es. `0 9 * * 1-5`."},"enabled":{"type":"boolean"},"spaceId":{"type":"string","format":"uuid","description":"Spazio dello scenario. Una chiave limitata a uno Spazio lo impone e rifiuta un altro Spazio."},"httpChain":{"type":"array","items":{"type":"object","additionalProperties":true,"description":"Chain: hop HTTP (login → API). Se presente, `url` può venire dal primo hop. `alwaysRun: true` contrassegna un hop di pulizia (disconnessione, eliminazione di una risorsa di test), eseguito anche dopo un errore, senza cambiare lo stato dell’esecuzione."}}},"required":["name","intervalSec"]},"example":{"type":"http","name":"Page d'accueil","url":"https://www.example.com","intervalSec":300,"expectedStatus":200,"maxLatencyMs":2000,"severity":"major","tags":["prod"]}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/scenarios/{id}":{"get":{"operationId":"get_v1_scenarios__id_","summary":"Leggere uno scenario","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"patch_v1_scenarios__id_","summary":"Modificare uno scenario","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":120},"url":{"type":"string","format":"uri","description":"Solo controllo HTTP."},"intervalSec":{"type":"integer","minimum":0,"maximum":2592000},"method":{"type":"string","enum":["GET","HEAD"]},"expectedStatus":{"type":"integer","minimum":100,"maximum":599},"maxLatencyMs":{"type":"integer","minimum":100,"maximum":600000},"enabled":{"type":"boolean"},"expectText":{"type":"string","maxLength":500,"nullable":true},"regions":{"type":"array","items":{"type":"string"},"maxItems":8},"scenario":{"type":"object","description":"Albero del percorso: elenco di passaggi (`goto`, `click`, `fill`, `assert_text`…) e, per una catena HTTP, `httpChain`. Veda la documentazione degli scenari.","additionalProperties":true,"properties":{"steps":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"tags":{"type":"array","items":{"type":"string","maxLength":40},"maxItems":10},"folder":{"type":"string","maxLength":60,"nullable":true},"severity":{"type":"string","enum":["critical","major","minor"]},"runbook":{"type":"string","maxLength":2000,"nullable":true},"cron":{"type":"string","maxLength":120,"nullable":true},"httpChain":{"type":"array","items":{"type":"object","additionalProperties":true}},"spaceId":{"type":"string","format":"uuid","nullable":true}}},"example":{"intervalSec":600,"maxLatencyMs":3000,"severity":"critical"}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"delete_v1_scenarios__id_","summary":"Eliminare uno scenario","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/scenarios/{id}/run":{"post":{"operationId":"post_v1_scenarios__id__run","summary":"Avviare un’esecuzione","description":"Mette in coda un’esecuzione e restituisce il suo `jobId`. Consuma quota: ambito `runs:trigger`.","tags":["runs"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"runs:trigger","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/scenarios/{id}/mute":{"post":{"operationId":"post_v1_scenarios__id__mute","summary":"Silenziare uno scenario","description":"`mutedUntil: null` riattiva lo scenario. Scadenza limitata a 30 giorni.","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"mutedUntil":{"type":"string","format":"date-time","nullable":true}},"required":["mutedUntil"]},"example":{"mutedUntil":"2026-10-01T06:00:00.000Z"}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/scenarios/{id}/baseline":{"post":{"operationId":"post_v1_scenarios__id__baseline","summary":"Fissare il riferimento di confronto sull’ultima esecuzione riuscita","tags":["scenarios"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"scenarios:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/runs":{"get":{"operationId":"get_v1_runs","summary":"Elencare le esecuzioni","tags":["runs"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"runs:read","parameters":[{"name":"scenarioId","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Filtra su uno scenario."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Dimensione della pagina, 100 per impostazione predefinita."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Valore `nextCursor` della risposta precedente. Assente nell’ultima pagina."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/runs/{id}":{"get":{"operationId":"get_v1_runs__id_","summary":"Leggere un’esecuzione e il suo esito","description":"`screenshotUrl`: link firmato allo screenshot del passaggio fallito, valido 15 minuti (`screenshotExpiresAt`), senza chiave. `null` senza screenshot. Rilegga l’esecuzione per ottenere un nuovo link.","tags":["runs"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"runs:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/incidents":{"get":{"operationId":"get_v1_incidents","summary":"Elencare gli incidenti","tags":["incidents"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"incidents:read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100},"description":"Dimensione della pagina, 100 per impostazione predefinita."},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"},"description":"Valore `nextCursor` della risposta precedente. Assente nell’ultima pagina."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/incidents/{id}":{"patch":{"operationId":"patch_v1_incidents__id_","summary":"Chiudere un incidente o pubblicarne il resoconto","description":"Riaprire un incidente cancella la sua data di risoluzione. `publicPostmortem` pubblica il resoconto sulla pagina di stato: da riservare a un testo riletto.","tags":["incidents"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"incidents:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["open","resolved"]},"postmortem":{"type":"string","maxLength":20000},"publicPostmortem":{"type":"boolean"}}},"example":{"status":"resolved","postmortem":"Certificat renouvelé, le contrôle repasse au vert.","publicPostmortem":false}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/members":{"get":{"operationId":"get_v1_members","summary":"Elencare i membri dell’organizzazione","description":"Nome, indirizzo e ruolo degli account collegati, per associare un incidente al suo responsabile. Nessun invito né modifica tramite chiave API.","tags":["members"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"members:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/webhooks":{"get":{"operationId":"get_v1_webhooks","summary":"Elencare i webhook in uscita","description":"L’URL registrato non viene mai restituito: è cifrato a riposo. `urlFingerprint` cambia se cambia la destinazione, il che basta a rilevare una deriva.","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"post_v1_webhooks","summary":"Creare un webhook in uscita","description":"Restituisce il segreto di firma una sola volta, alla creazione. Sono accettati solo URL pubblici https.","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","maxLength":500},"events":{"type":"array","items":{"type":"string","enum":["run.failed","run.recovered","incident.opened","incident.resolved"]},"minItems":1}},"required":["url"]},"example":{"url":"https://www.example.com/hooks/pathly","events":["run.failed","run.recovered"]}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/webhooks/{id}":{"get":{"operationId":"get_v1_webhooks__id_","summary":"Leggere un webhook in uscita","description":"Eventi ascoltati, stato e impronta della destinazione. L’URL resta cifrato.","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"delete_v1_webhooks__id_","summary":"Eliminare un webhook in uscita","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/hooks":{"post":{"operationId":"post_v1_hooks","summary":"Iscriversi a un evento di incidente (REST hooks)","description":"Per Zapier, Make o qualsiasi strumento di automazione: Pathly invia `incident.opened` o `incident.resolved` a `targetUrl`, firmato come un webhook. Richiede anche l’ambito `incidents:read`. Una chiave limitata a uno Spazio riceve solo gli incidenti del proprio Spazio. Una destinazione che risponde 410 viene disiscritta. Sono accettati solo URL pubblici https.","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"targetUrl":{"type":"string","format":"uri","maxLength":500},"event":{"type":"string","enum":["incident.opened","incident.resolved"]},"source":{"type":"string","enum":["zapier","make","n8n","api"]}},"required":["targetUrl","event"]},"example":{"targetUrl":"https://hooks.example.com/catch/123/abc","event":"incident.opened","source":"zapier"}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/hooks/{id}":{"delete":{"operationId":"delete_v1_hooks__id_","summary":"Annullare l’iscrizione a un evento di incidente","tags":["alerting"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"alerting:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/hooks/samples":{"get":{"operationId":"get_v1_hooks_samples","summary":"Esempi di eventi di incidente","description":"Gli ultimi tre incidenti, nel formato esatto dell’evento inviato. Serve a Zapier e Make per preparare la corrispondenza dei campi.","tags":["incidents"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"incidents:read","parameters":[{"name":"event","in":"query","required":false,"schema":{"type":"string","enum":["incident.opened","incident.resolved"]},"description":"Evento desiderato. `incident.resolved` restituisce solo incidenti risolti."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/maintenance-windows":{"get":{"operationId":"get_v1_maintenance_windows","summary":"Elencare le finestre di manutenzione","tags":["maintenance"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"maintenance:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"post_v1_maintenance_windows","summary":"Creare una finestra di manutenzione","description":"Due forme: una tantum (`startsAt` e `endsAt`) o settimanale (`weekday`, `startMinute`, `durationMin`).","tags":["maintenance"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"maintenance:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"monitorId":{"type":"string","format":"uuid","description":"Assente = tutta l’organizzazione.","nullable":true},"startsAt":{"type":"string","format":"date-time","description":"Finestra una tantum."},"endsAt":{"type":"string","format":"date-time","description":"Finestra una tantum, 90 giorni al massimo."},"reason":{"type":"string","maxLength":500},"weekday":{"type":"integer","minimum":1,"maximum":7,"description":"Finestra settimanale, 1 = lunedì."},"startMinute":{"type":"integer","minimum":0,"maximum":1439},"durationMin":{"type":"integer","minimum":15,"maximum":1440}}},"example":{"startsAt":"2026-10-04T01:00:00.000Z","endsAt":"2026-10-04T03:00:00.000Z","reason":"Migration de base"}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/maintenance-windows/{id}":{"get":{"operationId":"get_v1_maintenance_windows__id_","summary":"Leggere una finestra di manutenzione","tags":["maintenance"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"maintenance:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"delete_v1_maintenance_windows__id_","summary":"Eliminare una finestra di manutenzione","tags":["maintenance"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"maintenance:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/sla":{"get":{"operationId":"get_v1_sla","summary":"Misura degli obiettivi di disponibilità","description":"Tasso misurato e budget di errore residuo, per obiettivo.","tags":["sla"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"sla:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/sla-targets":{"get":{"operationId":"get_v1_sla_targets","summary":"Elencare la configurazione degli obiettivi","tags":["sla"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"sla:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"put":{"operationId":"put_v1_sla_targets","summary":"Creare o sostituire un obiettivo","description":"Un obiettivo per scenario, più un obiettivo globale senza `monitorId`. Una nuova chiamata sullo stesso bersaglio sostituisce l’obiettivo esistente.","tags":["sla"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"sla:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"monitorId":{"type":"string","format":"uuid","nullable":true},"name":{"type":"string","maxLength":120},"objectivePct":{"type":"number","minimum":50,"maximum":100},"windowDays":{"type":"integer","minimum":1,"maximum":365},"excludeMaintenance":{"type":"boolean"},"warnAtBudgetRatio":{"type":"number","minimum":0.1,"maximum":1},"enabled":{"type":"boolean"}},"required":["objectivePct","windowDays"]},"example":{"name":"Disponibilité globale","objectivePct":99.9,"windowDays":30,"excludeMaintenance":true}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/sla-targets/{id}":{"get":{"operationId":"get_v1_sla_targets__id_","summary":"Leggere un obiettivo","tags":["sla"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"sla:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"delete_v1_sla_targets__id_","summary":"Eliminare un obiettivo","tags":["sla"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"sla:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/settings":{"get":{"operationId":"get_v1_settings","summary":"Leggere le impostazioni dell’organizzazione","description":"I segreti di integrazione non escono mai: compaiono come booleani `has*`.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"patch_v1_settings","summary":"Modificare le impostazioni dell’organizzazione","description":"Sottoinsieme senza segreti. Slack, Teams, Discord, PagerDuty, Opsgenie, Datadog e Sentry restano riservati al back-office, per non scrivere segreti in un file di infrastruttura.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:write","requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"alertEmail":{"type":"string","format":"email","nullable":true},"alertOnRecovery":{"type":"boolean"},"escalationAfterFails":{"type":"integer","minimum":2,"maximum":20},"escalationEmail":{"type":"string","format":"email","nullable":true},"weeklyDigestEmail":{"type":"string","format":"email","nullable":true},"weeklyDigestEnabled":{"type":"boolean"},"statusSlug":{"type":"string","maxLength":64,"nullable":true},"statusPublic":{"type":"boolean"},"timezone":{"type":"string","maxLength":64},"sslWarnDays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":90},"maxItems":6},"domainWarnDays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":90},"maxItems":6},"triageEnabled":{"type":"boolean"},"triageConfirmEnabled":{"type":"boolean"},"triageLatencyFactor":{"type":"number","minimum":1.5,"maximum":10}}},"example":{"alertEmail":"supervision@example.com","alertOnRecovery":true,"escalationAfterFails":3,"timezone":"Europe/Paris"}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/usage":{"get":{"operationId":"get_v1_usage","summary":"Consumo del periodo","description":"Quanto basta per fermare una pipeline prima di esaurire la quota.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/spaces":{"get":{"operationId":"get_v1_spaces","summary":"Elencare gli Spazi","description":"Uno Spazio raggruppa gli scenari di un cliente, di un marchio o di un’applicazione. Risponde 404 finché gli Spazi non sono attivati per l’organizzazione. Una chiave limitata a uno Spazio vede solo il proprio.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"post_v1_spaces","summary":"Creare uno Spazio","description":"Entro i limiti del piano. Rifiutato a una chiave limitata a uno Spazio.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":80},"kind":{"type":"string","enum":["client","site","application"]}},"required":["name"]},"example":{"name":"Boutique en ligne","kind":"client"}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/spaces/{id}":{"get":{"operationId":"get_v1_spaces__id_","summary":"Leggere uno Spazio","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"patch_v1_spaces__id_","summary":"Modificare uno Spazio","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","maxLength":80},"kind":{"type":"string","enum":["client","site","application"]}}},"example":{"name":"Boutique"}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"delete":{"operationId":"delete_v1_spaces__id_","summary":"Archiviare uno Spazio","description":"I suoi scenari ne escono e restano monitorati. Nulla viene eliminato.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/status/components":{"get":{"operationId":"get_v1_status_components","summary":"Componenti della pagina di stato pubblica","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/account":{"get":{"operationId":"get_v1_account","summary":"Organizzazione, piano e quote","description":"Nome dell’organizzazione, piano, quote usate e residue (`limit: null` = senza quota), e `billingUrl`, la schermata Piano dell’app. Chiave limitata a uno Spazio: `used` conta solo il suo Spazio, `limit` e `remaining` restano quelli dell’organizzazione, di cui lo Spazio condivide le quote.","tags":["org"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"org:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/flow-assistant/detect":{"post":{"operationId":"post_v1_flow_assistant_detect","summary":"Lumi: riconoscere un sito","description":"Legge la home page (protezione SSRF), indica il tipo di sito e se restano prove per oggi. Non consuma prove. `available: false` con `reason`: `off` (assistente in pausa), `url_blocked`, `unreachable` o `quota`.","tags":["assistant"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"assistant:run","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2000}},"required":["url"]},"example":{"url":"https://boutique.example.com"}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/flow-assistant/trials":{"post":{"operationId":"post_v1_flow_assistant_trials","summary":"Lumi: preparare dei Flow","description":"Avvia una prova (202, `{ id }`), poi la legga fino a `ready`, `not_found` o `failed`. Stessi limiti dell’app: prove al giorno del piano (403 `assistant_quota`), tetto di costo dell’IA, interruttore `kill_flow_assistant` (403 `assistant_off`), coda piena (429 `assistant_busy`). `confirmOwner: true`: Lei gestisce questo sito.","tags":["assistant"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"assistant:run","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","maxLength":2000},"confirmOwner":{"const":true}},"required":["url","confirmOwner"]},"example":{"url":"https://boutique.example.com","confirmOwner":true}}}},"responses":{"202":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/flow-assistant/trials/{id}":{"get":{"operationId":"get_v1_flow_assistant_trials__id_","summary":"Lumi: leggere una prova","description":"Stato della prova e, una volta pronta, i Flow rieseguiti con successo (`proposals`), i posti Flow residui (`slots`) e la frequenza consigliata (`advice`).","tags":["assistant"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"assistant:run","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/flow-assistant/trials/{id}/save":{"post":{"operationId":"post_v1_flow_assistant_trials__id__save","summary":"Lumi: salvare un Flow proposto","description":"Crea il Flow `index` della prova e avvia la sua prima esecuzione. Entro i limiti del piano (403 `PLAN_LIMIT`). Già salvato: 409 `already_saved` con `monitorId`. Chiave limitata a uno Spazio: il Flow entra nel suo Spazio.","tags":["assistant"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"assistant:save","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"index":{"type":"integer","minimum":0,"maximum":9},"name":{"type":"string","maxLength":120},"intervalSec":{"type":"integer","minimum":60,"maximum":604800},"steps":{"type":"array","items":{"type":"object"},"minItems":2,"maxItems":50}},"required":["index"]},"example":{"index":0,"name":"Tunnel de commande"}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/status-pages":{"get":{"operationId":"get_v1_status_pages","summary":"Elencare le pagine di stato","description":"La pagina dell’organizzazione (`kind: organization`, `id` = organizzazione) e quelle degli Spazi (`kind: space`, `id` = Spazio), con il loro indirizzo pubblico (`url`) e il loro badge SVG (`badgeUrl`, `?v=uptime` per la disponibilità). Il badge della pagina dell’organizzazione richiede `?monitor=<scenarioId>` quando conta più scenari. Chiave limitata a uno Spazio: solo la pagina del suo Spazio.","tags":["status"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"status:read","responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"post":{"operationId":"post_v1_status_pages","summary":"Creare una pagina di stato","description":"Senza `spaceId`: la pagina dell’organizzazione, all’indirizzo `slug` (proposto in base al nome se assente). Con `spaceId`: la pagina dello Spazio, sotto l’indirizzo dell’organizzazione, creata se necessario. Non pubblicata salvo `public: true`. Già presente: restituita così com’è. Un indirizzo già occupato: 409.","tags":["status"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"status:write","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"},"description":"Restituisce la stessa risposta per 24 ore invece di creare un duplicato. Indispensabile in una pipeline che può riprovare."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"spaceId":{"type":"string","format":"uuid"},"slug":{"type":"string","maxLength":64,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"},"public":{"type":"boolean"}}},"example":{"slug":"boutique-exemple","public":true}}}},"responses":{"201":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"409":{"description":"`Idempotency-Key` già usata con un altro corpo.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}},"/v1/status-pages/{id}":{"get":{"operationId":"get_v1_status_pages__id_","summary":"Leggere una pagina di stato","tags":["status"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"status:read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}},"patch":{"operationId":"patch_v1_status_pages__id_","summary":"Pubblicare o ritirare una pagina di stato","description":"`public` pubblica o ritira la pubblicazione. `slug` cambia l’indirizzo della pagina dell’organizzazione: i link e i badge già inseriti smettono di rispondere.","tags":["status"],"security":[{"bearerAuth":[]}],"x-pathly-scope":"status:write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"},"description":"Identificativo."}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"public":{"type":"boolean"},"slug":{"type":"string","maxLength":64,"pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"}}},"example":{"public":false}}}},"responses":{"200":{"description":"Operazione riuscita.","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Corpo o parametro non valido.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"401":{"description":"Chiave API assente, sconosciuta, revocata o scaduta.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"403":{"description":"La chiave non ha l’ambito richiesto.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"404":{"description":"Risorsa non trovata in questa organizzazione.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}},"429":{"description":"Troppe chiamate per questa chiave.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"]}}}}}}}},"x-pathly-language":"it"}