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

# Update Pixel

> Update pixel metadata and runtime settings

<ParamField path="pixelId" type="string" required>
  Pixel identifier
</ParamField>

## Request Body

All fields are optional.

<ParamField body="name" type="string">
  New name
</ParamField>

<ParamField body="description" type="string">
  New description (`null` to clear)
</ParamField>

<ParamField body="eventName" type="string">
  New event label (`null` to clear)
</ParamField>

<ParamField body="captureParams" type="array">
  Replace capture parameter set
</ParamField>

<ParamField body="conversionTracking" type="boolean">
  Toggle conversion tracking
</ParamField>

<ParamField body="enabled" type="boolean">
  Enable or disable the pixel
</ParamField>

<ParamField body="expiresAt" type="string">
  ISO datetime or `null` to clear expiry
</ParamField>

<ParamField body="firesLimit" type="number">
  Positive integer limit or `null`
</ParamField>

## Access

* Permission: `pixels:update`

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.linquid.io/api/pixels/pixel_abc123 \
    -H "Authorization: Bearer <token>" \
    -H "Content-Type: application/json" \
    -d '{
      "enabled": false,
      "firesLimit": 10000
    }'
  ```
</RequestExample>

## Common Errors

* `404`: pixel not found in workspace
