# Atualiza uma customização Atualiza uma customização existente. Endpoint: PUT /api/v3/customizations/{customizationId} Version: 3.0.0 Security: OAuth2 ## Header parameters: - `CPlug-Company-Id` (number, required) Id da Empresa (Company). Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas. Example: 12 - `Idempotency-Key` (string, required) UUID aleatório gerado por você. Nós utilizamos esse header para evitar duplicidade de registros, ou seja, caso você não tenha recebido a resposta de alguma requisição e mandar o mesmo UUID, nós não duplicaremos o registro. ## Path parameters: - `customizationId` (integer, required) Identificador único da customização. Example: 123 ## Request fields (application/json): - `name` (string, required) Nome da customização. Example: "Customização Promocional" - `type` (string, required) Tipo da customização. - FULL_VIDEO: Vídeo em tela cheia - BACK_VIDEO: Vídeo de fundo - FULL_IMAGE: Imagem em tela cheia - BACK_IMAGE: Imagem de fundo - DYNAMIC_CATEGORY: Categoria dinâmica Enum: "FULL_VIDEO", "BACK_VIDEO", "FULL_IMAGE", "BACK_IMAGE", "DYNAMIC_CATEGORY" - `transition` (null,string) Tipo de transição aplicada à customização. Obrigatório para tipos FULL_IMAGE e BACK_IMAGE. - FALL: Transição de queda - SLIDE: Transição de deslizamento - FADE: Transição de esmaecimento Enum: "FALL", "SLIDE", "FADE" ## Response 200 fields (application/json): - `data` (object) Representa uma customização da tela. - `data.id` (integer) Identificador único da customização. Example: 123 - `data.name` (string) Nome da customização. Example: "Customização Promocional" - `data.type` (string) Tipo da customização. - FULL_VIDEO: Vídeo em tela cheia - BACK_VIDEO: Vídeo de fundo - FULL_IMAGE: Imagem em tela cheia - BACK_IMAGE: Imagem de fundo - DYNAMIC_CATEGORY: Categoria dinâmica Enum: "FULL_VIDEO", "BACK_VIDEO", "FULL_IMAGE", "BACK_IMAGE", "DYNAMIC_CATEGORY" - `data.transition` (null,string) Tipo de transição aplicada à customização. Obrigatório para tipos FULL_IMAGE e BACK_IMAGE. - FALL: Transição de queda - SLIDE: Transição de deslizamento - FADE: Transição de esmaecimento Enum: "FALL", "SLIDE", "FADE" - `data.medias` (array) Lista de mídias associadas à customização. - `data.medias.id` (integer) Identificador único da mídia. Example: 123 - `data.medias.filename` (string) Nome do arquivo da mídia. Example: "customization_video.mp4" - `data.medias.type` (string) Tipo da mídia. - IMAGE: Imagem (PNG, JPG, JPEG) - VIDEO: Vídeo (MP4) Enum: "IMAGE", "VIDEO" - `data.medias.filesize` (integer) Tamanho do arquivo em bytes. Example: 1024000 - `data.medias.url` (null,string) URL para acesso à mídia via CDN. Example: "https://cdn.example.com/customizations/customization_video.mp4" ## Response 400 fields (application/json): - `code` (string, required) Código de erro. Example: "missing_headers" - `message` (string) Descrição do erro. Example: "error message" - `meta` (array) Dados adicionais sobre o erro. ## Response 422 fields (application/json): - `code` (string, required) Código de erro. Example: "uneditable_entity" - `message` (string) Descrição do erro. Example: "description error" - `meta` (array) Dados adicionais sobre o erro. - `meta.field` (string, required) Nome do campo no qual existe um erro de validação. Example: "name" - `meta.validations` (array) - `meta.validations.type` (string, required) Tipo da validação aplicada. Example: "Required" - `meta.validations.value` (array) Tipo de valor aplicável (esse campo pode ser vazio). ## Response 401 fields ## Response 404 fields