> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Galeria de Mídia: Envie, Liste e Remova Arquivos

> Faça upload, liste com paginação e exclua arquivos da galeria de mídia do PanÐá Zap usando a API externa.

A **galeria** é uma biblioteca de mídia compartilhada dentro do tenant — imagens, vídeos e documentos reutilizados em respostas rápidas, campanhas e fluxos de chatbot. Use os endpoints abaixo para manter a galeria sincronizada com uma biblioteca de ativos externa (DAM, CMS, etc.).

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

***

## Enviar arquivo para a galeria

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/gallery/upload
Content-Type: multipart/form-data
```

| Campo         | Tipo    | Obrigatório | Descrição                                                      |
| ------------- | ------- | ----------- | -------------------------------------------------------------- |
| `media`       | arquivo | Sim         | Arquivo a ser enviado — imagem, vídeo ou documento.            |
| `description` | string  | Não         | Descrição ou legenda do arquivo, exibida na galeria do painel. |

```json Exemplo de body adicional theme={null}
{
  "description": "Arquivo de marketing"
}
```

***

## Listar arquivos da galeria

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/gallery/list?pageNumber=1&fileType=image
```

| Query param  | Tipo    | Obrigatório | Descrição                                                                                                     |
| ------------ | ------- | ----------- | ------------------------------------------------------------------------------------------------------------- |
| `pageNumber` | integer | Não         | Número da página a retornar (padrão: `1`).                                                                    |
| `fileType`   | string  | Não         | Filtra por tipo de arquivo — por exemplo, `image`, `video` ou `document`. Omita para retornar todos os tipos. |

***

## Excluir arquivo da galeria

```http theme={null}
POST https://{BaseUrl}/v2/api/external/{ApiID}/gallery/delete/{id}
```

| Parâmetro de Caminho | Tipo    | Obrigatório | Descrição                                |
| -------------------- | ------- | ----------- | ---------------------------------------- |
| `id`                 | integer | Sim         | ID do arquivo da galeria a ser excluído. |

Nenhum corpo de requisição é necessário.

<Warning>
  A exclusão é permanente. Arquivos já usados em respostas rápidas ou fluxos de chatbot publicados podem deixar de carregar corretamente após a remoção.
</Warning>

***

## Resposta Padrão

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```

Em `gallery/list`, `data` traz o array de arquivos da página solicitada junto com os metadados de paginação.