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

# Update Creator Reference

> Set or update the creator reference value on an existing token.

<Card title="Update Card Data Guide" icon="book" href="/manage-tokens/update-card-data">
  Modify expiration dates and creator references on tokens
</Card>

Sets or updates the creator reference label on an existing token. The creator reference is a merchant-defined string that lets you look up tokens by your own identifiers, such as a booking or reservation number.

## Error Responses

| Code  | HTTP Status | Condition                        |
| ----- | ----------- | -------------------------------- |
| -1003 | 401         | User is not the owner            |
| -179  | 400         | creatorReference is empty        |
| -125  | 400         | Setting creator reference failed |

## Parameters

### Headers

<ParamField header="Authorization" type="string" required>
  Your API key prefixed with `APIKEY`. Example: `APIKEY your-api-key`. See the [Authentication guide](/getting-started/authentication).
</ParamField>

### Path Parameters

<ParamField path="token" type="string" required>
  The token ID as returned by one of the tokenization methods. For example, `2821a46d80e14d1b96a7f18f1b81926d`.
</ParamField>

<ParamField path="creatorReference" type="string" required>
  The new creator reference value to assign to this token. Can be used later to [query for tokens](/api-reference/manage-tokens/query-tokens) by reference.
</ParamField>

<RequestExample>
  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/creatorReference/booking-12345',
    {
      method: 'PUT',
      headers: {
        'Authorization': 'APIKEY your-api-key'
      }
    }
  );

  console.log(response.status);
  ```

  ```python Python theme={null}
  import requests

  response = requests.put(
      'https://service.pcibooking.net/api/payments/paycard/2821a46d80e14d1b96a7f18f1b81926d/creatorReference/booking-12345',
      headers={'Authorization': 'APIKEY your-api-key'}
  )

  print(response.status_code)
  ```
</RequestExample>

## Response

**200** - Creator reference updated successfully.

<ResponseExample>
  ```text 200 theme={null}
  Creator reference updated successfully. No content returned.
  ```

  ```json 400 theme={null}
  {
      "code": -125,
      "message": "Bad input data",
      "moreInfo": "Invalid token or creator reference",
      "errorList": null
  }
  ```

  ```json 401 theme={null}
  {
      "code": -1003,
      "message": "Not authorized to access this resource",
      "moreInfo": "Bad or missing authorization data, expected APIKEY",
      "errorList": null
  }
  ```

  ```json 404 theme={null}
  {
      "code": -160,
      "message": "Uri not found",
      "moreInfo": "Uri to Bank card not found",
      "errorList": null
  }
  ```
</ResponseExample>