1

Dear X Developer Community,

We want to inform you of an important update to the X API that will take effect today, February 18, 2025. Specifically regarding the affiliation.user_id field.

What’s Changing?

Previously, the affiliation.user_id field in API responses returned a single user_id as a string, even if a user had multiple affiliations.

For example:

{
  "data": {
    "affiliation": {
      "user_id": "1072254151508275200"
    }
  }
}

As of today, this field will now return an array of user_id values to reflect all affiliations a user may have. The updated response will look like this:

{
  "data": {
    "affiliation": {
      "user_id": [
        "1072254151508275200",
        "1815006710651551745"
      ]
    }
  }
}

This change ensures that the API accurately represents multiple affiliations, addressing a limitation that previously impacted data completeness.

Who Is Impacted?

This change affects developers using the following parameters in their API requests:

  • user.fields=affiliation

If your application assumes affiliation.user_id is a single string rather than an array, you will need to update your code to handle the new list format.

We sincerely apologize for the urgency of this change and appreciate your understanding and flexibility as we work to improve the X API for everyone. Thank you for your continued support and partnership.

Best regards,

X Developer Platform Team

11 Likes