---
title: "Enviar imagem"
description: "PUT /v1/catalog/{resourceType}/{resourceId}/image — enviar ou substituir a imagem de um setor, produto ou complemento no cardápio BeeFood."
method: "PUT"
path: "/v1/catalog/{resourceType}/{resourceId}/image"
url: "https://developer.beefood.com.br/docs/catalogo/enviar-imagem"
group: "Catálogo"
scope: "catalog:write"
lang: "pt"
---
# Enviar imagem

`PUT /v1/catalog/{resourceType}/{resourceId}/image`

- Produção: `https://api.beefood.app/v1/catalog/{resourceType}/{resourceId}/image`
- Sandbox: `https://api-sandbox.beefood.app/v1/catalog/{resourceType}/{resourceId}/image`

Envia ou substitui a imagem do recurso.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `catalog:write`. Limite: 300 requisições a cada 3 minutos.

## Observações

- Formatos aceitos: PNG, JPEG, WEBP e GIF.


## Parâmetros de path

- `resourceType` *enum<string>* **obrigatório** — Tipo do recurso dono da imagem. Exemplo: `products`.
  - *Valores:* `sectors`, `products`, `complements`

- `resourceId` *integer* **obrigatório** — ID do setor, produto ou complemento. Exemplo: `221145`.



## Parâmetros do body

- `file` *string* **obrigatório** — Imagem em base64. Aceita também o formato data URL (data:image/png;base64,...). Exemplo: `"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."`.



## Exemplos de requisição

### cURL

```bash
curl -X PUT "https://api.beefood.app/v1/catalog/{resourceType}/{resourceId}/image" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}'
```


## Exemplos de resposta

### 200 OK

```json
{
  "url": "https://beetech-imagens.s3-sa-east-1.amazonaws.com/38311/2f6c1d0e-7b1a-4c55-9f0e-1a2b3c4d5e6f.jpg"
}
```


## Campos da resposta

- `url` *string* — URL da imagem salva.



## Erros

| Status | Mensagem |
| --- | --- |
| 400 | 'resourceType' must be one of: sectors, products, complements |
| 400 | 'resourceId' must be a positive integer |
| 400 | 'file' must be a base64 string |
| 400 | 'file' must be a PNG, JPEG, WEBP or GIF image |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the catalog:write scope |
| 404 | Product ID {id} not found |
| 404 | Complement ID {id} not found |
| 404 | Sector ID {id} not found |
| 429 | Too many requests |


## Vocabulários usados neste endpoint

## Catálogo · resourceType

Tipo do recurso dono da imagem, usado na rota de envio e remoção de imagens do catálogo.

| Valor | Significado | Uso |
| --- | --- | --- |
| `sectors` | Setor | /v1/catalog/{resourceType}/{resourceId}/image |
| `products` | Produto | /v1/catalog/{resourceType}/{resourceId}/image |
| `complements` | Complemento | /v1/catalog/{resourceType}/{resourceId}/image |