> ## 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.

# Update data list

> Update a data list metadata: name, description, type, source, configuration, field mappings, and priority — PATCH /data-lists/{id}.

## Overview

Updates metadata for a list you are allowed to edit. Changing **`name`** or **`description`** updates what operators see in the **dashboard** (labels and detail text); it does not change matching behavior. **Global** lists: only **name** and **description** may be changed, and only by **system administrators**.

## Endpoint

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

## Authentication

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

## Request Body

All fields optional; send only what changes:

<ParamField body="name" type="string">
  1–200 characters. Shown in the dashboard for identification.
</ParamField>

<ParamField body="description" type="string">
  Max 1000 characters. Shown where the app displays list details (internal context for your team).
</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>

## Response

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