Update avatar

PATCH

profile

avatar

Update avatar

curl --request PATCH \
  --url https://xquik.com/api/v1/x/profile/avatar \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": "<string>",
  "file": {},
  "url": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/profile/avatar"

payload = {
    "account": "<string>",
    "file": {},
    "url": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({account: '<string>', file: {}, url: '<string>'})
};

fetch('https://xquik.com/api/v1/x/profile/avatar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/profile/avatar"

	payload := strings.NewReader("{\n  \"account\": \"<string>\",\n  \"file\": {},\n  \"url\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

10 credits per call · All plans from $0.00012/credit

curl -X PATCH https://xquik.com/api/v1/x/profile/avatar \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -F "account=myxaccount" \
  -F "file=@avatar.png" | jq

const fs = require("fs");
const FormData = require("form-data");

const form = new FormData();
form.append("account", "myxaccount");
form.append("file", fs.createReadStream("avatar.png"));

const response = await fetch("https://xquik.com/api/v1/x/profile/avatar", {
  method: "PATCH",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
  },
  body: form,
});
const data = await response.json();

import requests

with open("avatar.png", "rb") as f:
    response = requests.patch(
        "https://xquik.com/api/v1/x/profile/avatar",
        headers={"x-api-key": "xq_YOUR_KEY_HERE"},
        files={"file": ("avatar.png", f, "image/png")},
        data={"account": "myxaccount"},
    )
data = response.json()

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "os"
)

func main() {
    var buf bytes.Buffer
    writer := multipart.NewWriter(&buf)
    writer.WriteField("account", "myxaccount")

    file, err := os.Open("avatar.png")
    if err != nil {
        panic(err)
    }
    defer file.Close()

    part, err := writer.CreateFormFile("file", "avatar.png")
    if err != nil {
        panic(err)
    }
    io.Copy(part, file)
    writer.Close()

    req, err := http.NewRequest("PATCH", "https://xquik.com/api/v1/x/profile/avatar", &buf)
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")
    req.Header.Set("Content-Type", writer.FormDataContentType())

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

curl -X PATCH https://xquik.com/api/v1/x/profile/avatar \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "myxaccount",
    "url": "https://example.com/avatar.png"
  }' | jq

Headers

x-api-key

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Content-Type

string

required

Use multipart/form-data for file uploads or application/json for URL uploads. Most HTTP clients set the multipart boundary automatically.

Body

account

string

required

X username or account ID of your connected account to act as.

file

binary

Multipart upload file. Required unless url is provided. Accepted formats: JPEG, PNG. Maximum file size: 700 KB.

url

string

JSON upload URL. Required unless file is provided. Must be an HTTPS URL that Xquik can fetch directly.

Response

success

boolean

Always true on success.

{
  "success": true
}

{ "error": "invalid_input", "message": "Invalid file format or size exceeded" }

The file is not a supported format (JPEG, PNG) or exceeds the 700 KB limit.

{ "error": "unauthenticated", "message": "Missing or invalid API key" }

Missing or invalid API key.

{ "error": "no_subscription", "message": "No active subscription" }

An active subscription is required. Subscribe from the dashboard.

{ "error": "insufficient_credits", "message": "Insufficient credits" }

Insufficient credits for this operation. Top up your credit balance from the dashboard.

{ "error": "account_needs_reauth" }

The connected X account failed a recent login attempt and needs to be reconnected. Reconnect it from the dashboard.

{ "error": "account_restricted" }

The connected X account is locked, suspended, recovering, or temporarily restricted. Resolve the restriction on X before retrying.

{ "error": "account_not_found", "message": "X account not found. Connect it first at /dashboard/account?tab=x-accounts." }

The specified account is not connected to your Xquik account. Connect it from the dashboard.

{ "error": "x_content_too_long", "message": "..." }

X rejected the write or the media URL could not be downloaded. Possible codes: x_content_too_long, x_duplicate_action, x_account_suspended, x_account_protected, x_target_not_found, x_account_feature_required, x_rejected, media_download_failed (URL fetch path only - body.url not HTTPS, resolves to private IP, file too large, origin error, or timeout). See error handling for details.

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

The request hit an Xquik tier limit, or X throttled the avatar update. Possible codes: rate_limit_exceeded, x_rate_limited, or x_daily_limit. Respect the Retry-After header when present.

{ "error": "x_transient_error", "message": "..." }

A transient write service issue occurred. Safe to retry with exponential backoff.

{ "error": "x_write_failed", "message": "Failed to complete the action" }

The write action failed. Retry after a short delay.

Related: Update Banner to change the profile banner, or Update Profile to update name, bio, and other text fields.

Last modified on May 9, 2026

Update bannerUpload a new profile banner for one of your connected X accounts

Update avatar

curl --request PATCH \
  --url https://xquik.com/api/v1/x/profile/avatar \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "account": "<string>",
  "file": {},
  "url": "<string>"
}
'

import requests

url = "https://xquik.com/api/v1/x/profile/avatar"

payload = {
    "account": "<string>",
    "file": {},
    "url": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "<content-type>"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'x-api-key': '<api-key>', 'Content-Type': '<content-type>'},
  body: JSON.stringify({account: '<string>', file: {}, url: '<string>'})
};

fetch('https://xquik.com/api/v1/x/profile/avatar', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/profile/avatar"

	payload := strings.NewReader("{\n  \"account\": \"<string>\",\n  \"file\": {},\n  \"url\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "<content-type>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

​Headers

​Body

​Response

Headers

Body

Response