Roteiros

Criar roteiro

Salva um novo roteiro na biblioteca da conta.

POSThttps://livetp.app/api/v1/scripts

O roteiro aparece imediatamente na biblioteca web e nos apps conectados. Requer o escopo scripts:write.

Corpo da requisição

titlestringcorpoobrigatório

Título do roteiro, de 1 a 160 caracteres. Espaços nas pontas são removidos.

contentstringcorpoobrigatório

Texto que será lido no teleprompter, com até 100 mil caracteres. Pode ser vazio. Quebras de linha \r\n são normalizadas para \n.

statusstringcorpoobrigatório

Etapa do roteiro: draft (rascunho), ready (pronto), review (em revisão) ou completed (concluído). O valor legado done é aceito e salvo como completed.

idstring (uuid)corpo

Identificador escolhido pelo cliente. Repetir uma criação com o mesmo id retorna 409 em vez de duplicar o roteiro. Veja como evitar duplicados.

Resposta

Retorna 201 Created com o objeto roteiro, o header Location com o caminho do recurso e o header ETag com a revisão ("1").

scriptobject

O roteiro criado, já com revision: 1.

Erros

StatusCódigoQuando
409conflictJá existe um roteiro com esse id. Se ele for seu, error.details.current traz a versão salva.
415unsupported_media_typeO corpo não foi enviado como application/json.
422invalid_inputAlgum campo é inválido. error.details lista os problemas por campo.

Consulte a lista completa em Erros.