Skip to main content
PUT
Update account settings

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
allow_dms_from
enum<string>

Who can send the user direct messages: all (anyone), verified (verified accounts only), or following (accounts the user follows).

Available options:
all,
following,
verified
allow_media_tagging
enum<string>

Who may tag the user in media: all (anyone), following (accounts the user follows), or none.

Available options:
all,
following,
none
always_allow_dms_from_subscribers
boolean

Whether the user's subscribers can always message them regardless of allow_dms_from.

discoverable_by_email
boolean

Whether people who have the user's email address can find them on X.

discoverable_by_phone
boolean

Whether people who have the user's phone number can find them on X.

display_sensitive_media
boolean

Whether media that may contain sensitive content is displayed to the user.

language
string

The language of the account, as a BCP 47 tag (for example en, pt-BR).

Required string length: 2 - 35
location_tagging_enabled
boolean

Whether a precise location may be attached to the user's posts.

protected
boolean

Whether the user's posts are protected (visible only to approved followers).

quiet_hours
object

The daily window during which the user does not receive push and SMS notifications.

time_zone
object

The time zone of the account.

Whether X may use the user's off-X web activity to personalize their experience.

Response

The request has succeeded.

data
object
errors
object[]