Roteiros
Atualizar roteiro
Substitui título, texto e status de um roteiro ativo.
PUT
https://livetp.app/api/v1/scripts/{id}A atualização é completa: envie os três campos, mesmo que só um tenha mudado. Requer o escopo scripts:write.
A gravação só acontece se expectedRevision for igual à revisão atual. Caso contrário, nada é alterado e a resposta é 409. Veja Revisões e conflitos.
Parâmetros de caminho
idstring (uuid)caminhoobrigatório
Identificador do roteiro.
Corpo da requisição
expectedRevisionintegercorpoobrigatório
A revisão lida em Ler roteiro.
titlestringcorpoobrigatório
Título, de 1 a 160 caracteres.
contentstringcorpoobrigatório
Texto completo, com até 100 mil caracteres.
statusstringcorpoobrigatório
draft, ready, review ou completed.
Resposta
Retorna o roteiro com a nova revisão e o header ETag. Mudanças de título, texto ou status emitem os webhooks script.updated e, se o status mudou, script.status_changed.
Erros
| Status | Código | Quando |
|---|---|---|
404 | not_found | O roteiro não existe ou é de outra conta. |
409 | conflict | A revisão mudou ou o roteiro está na lixeira. error.details.current traz a versão salva. |
422 | invalid_input | Campos inválidos ou ausentes. |