Write Actions

Update Profile

Update the profile of the account behind your registered session. Send only the fields you want to change: this is a genuine PARTIAL update, and anything you omit is left exactly as it was rather than being blanked. At least one of name, description, location or url is required. Billed at $0.0016 per call. Cost: $0.0016 per call.

post/user/update_profile

Request

  • Base URL: https://api.twitterapis.com/twitter
  • URL: https://api.twitterapis.com/twitter/user/update_profile
  • Auth: HTTP bearer

Request body

namestring

New display name, up to 50 characters. Omit to leave it unchanged.

descriptionstring

New bio. Send an EMPTY STRING to clear it; omitting the field entirely leaves it alone. Those are two different things.

locationstring

New location text. Same rule: an empty string clears it, omitting the field leaves it alone.

urlstring

New profile link.

Example request

{
  "name": "Acme Research",
  "description": "Building things people can check.",
  "url": "https://www.twitterapis.com"
}

Response

Change your own display name, bio, location or link. A PARTIAL update.

okboolean

True when X accepted the update.

updated_fieldsstring[]

The field names you sent on this call, echoed back. It reports what was SUBMITTED, not a diff against your previous profile, so a field you set to the value it already had still appears here.

Changes

No recorded changes to this operation across all 1 revision of this API.