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

# Update Eligible Users

This endpoint allows you to update existing eligible users. A match is made using the `end_user` field, and any metadata (such as `tags`, `active_from`, or `active_to`) is replaced accordingly.

You need an API key to authenticate. See [here](/embedded-pages/quickstart) for more information about the API keys.

<ParamField body="users" type="PlatformUser[]" required>
  A list of user objects to update.

  <Expandable title="properties">
    <ParamField path="end_user" type="string" required>
      The identifier used for the end-user you want to update.
    </ParamField>

    <ParamField body="tags" type="object" required>
      A dictionary of key-values that should be associated with the user.
    </ParamField>

    <ParamField path="active_from" type="string" required>
      When the user started being active on the platform.
    </ParamField>

    <ParamField path="active_to" type="string" optional>
      When the user was deactivated (if applicable).
    </ParamField>
  </Expandable>
</ParamField>

<ResponseField name="users" type="EligibleUser[]">
  The list of users that were successfully updated.

  <Expandable title="properties">
    <ParamField path="end_user" type="string" required>
      The identifier used for the end-user you want to update.
    </ParamField>

    <ParamField body="tags" type="object" required>
      A dictionary of key-values that should be associated with the user.
    </ParamField>

    <ParamField path="active_from" type="string" required>
      When the user started being active on the platform.
    </ParamField>

    <ParamField path="active_to" type="string" optional>
      When the user was deactivated (if applicable).
    </ParamField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  { "users": 
    [
      {
        "end_user": "alice@example.com",
        "tags": { 
          "Product Tier": "Premium", 
          "Country": "US" 
        },
        "active_from": "2026-01-01",
      },
      {
        "end_user": "bob@example.com",
        "tags": { 
          "Product Tier": "Standard", 
          "Country": "CA" 
        },
        "active_from": "2025-06-23",
        "active_to": "2026-01-12"
      }
    ] 
  }
  ```
</ResponseExample>