Update Profile API

POST user/update_profile changes the display name, bio, location or link on the account behind your registered twitterapis session. It is a PARTIAL update: omitted fields keep their current values rather than being cleared, so you can send just a name. At least one field is required. It returns ok and updated_fields, and costs $0.0016 a call.

curl -X POST "https://example.com/user/update_profile" \  -H "Content-Type: application/json" \  -d '{}'

{  "ok": true,  "updated_fields": [    "name"  ]}

{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}

{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}

{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}

{  "error": "forbidden",  "message": "The acting account is not authorized for this write action, or has no logged-in session."}

{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}

{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}

{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

When to use

Use it to change your own profile text, for example keeping a bio in sync with a status your system already tracks. It only ever writes the account behind your session; there is no way to edit anyone else's profile, and reading any public profile is user/info instead.

Notes

• A PARTIAL update, verified rather than assumed: sending only name against an account with a non-empty bio returned 200 and left the bio intact. X's own web client sends the whole editable set on every save, so the partial form is a shape its client never sends, which is why this was tested before being published.
• An empty string does NOT clear a field. It is trimmed and treated exactly like omitting the field, so a request carrying only an empty value is refused with the same 400 as an empty request. Clearing a field is not something this endpoint can do yet; it is tracked and will be documented here when it lands rather than described before it works.
• At least one of name, description, location or url is required. A request carrying none of them is refused with 400 rather than sent upstream.
• Needs a session for the account you are acting as: either register one once (POST /customer/session), or pass per-call inline credentials as x-auth-token and x-ct0 request headers, which let a single API key act as many accounts. Returns 409 session_required if neither is supplied, 401 session_dead when the session has expired.
• This writes your own profile and takes effect immediately on x.com. There is no undo; read your current values with user/info first if you need to restore them.

Related endpoints

• User Info by Username: Fetch a full profile by @handle.
• Register Session: Register your auth_token and ct0 cookies once so every write and private read acts as your account, or pass them per call as x-auth-token / x-ct0 headers.
• Create Tweet: Post a tweet as your registered account: text, media, reply, or quote.

FAQ

Will sending only a name wipe my bio?

No. Omitted fields are preserved. That was tested directly on an account with a non-empty bio before this endpoint was published: name only, HTTP 200, bio unchanged. Nor can you clear a field on purpose: an empty string is trimmed and treated as an omission, so it leaves the value where it is.

Can I update someone else's profile?

No. The call acts as the account behind your registered session or your per-call inline credentials, and there is no parameter that names a different account.

What does updated_fields tell me?

Which field names your request carried. It is an echo of what you submitted rather than a diff, so a field you set to the value it already held is still listed. Read the profile back with user/info if you need to confirm the resulting state.