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

# Atualizar data list

> Atualiza os metadados de uma lista: nome, descrição, tipo, fonte, configuração, mapeamentos de campos e prioridade — PATCH /data-lists/{id}.

## Visão geral

Atualiza metadados de uma lista que você possa editar. Alterar **`name`** ou **`description`** atualiza o que os operadores veem no **dashboard** (rótulos e texto de detalhe); **não** muda o comportamento de correspondência. **Listas globais**: apenas **nome** e **descrição**, somente **administradores do sistema**.

## Endpoint

```
PATCH https://api.gu1.ai/data-lists/{id}
```

## Autenticação

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## Corpo da solicitação

Todos os campos são opcionais; envie apenas o que mudar:

<ParamField body="name" type="string">
  1–200 caracteres. Exibido no dashboard para identificação.
</ParamField>

<ParamField body="description" type="string">
  Máx. 1000 caracteres. Exibido onde o app mostra detalhes da lista (contexto interno para a equipe).
</ParamField>

<ParamField body="type" type="string">
  List type enum (same as create).
</ParamField>

<ParamField body="source" type="string">
  Source enum (same as create).
</ParamField>

<ParamField body="config" type="object">
  Same shape as create (`autoSync`, `syncFrequency`, `externalUrl`, `visibleItemDataColumns`, etc.).
</ParamField>

<ParamField body="fieldMappings" type="object">
  String map.
</ParamField>

<ParamField body="priority" type="number">
  1–100.
</ParamField>

## Resposta

`200` with updated list payload on success; `403`/`401` when attempting restricted changes on global lists.