# twitr.sh X/Twitter Profile Editor

> twitr.sh X/Twitter Profile Editor is a paid API for AI agents from twitr.sh, paid per call via x402, $0.012/call, status unknown (last checked 2026-10-13).

Update an X/Twitter account's profile fields — display name, bio, location, website URL, avatar, or banner image — via pay-per-call USDC payment.

## Facts

- Endpoint: POST https://twitr.sh/api/tools/x_profile?utm_source=zero.xyz
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitr-sh-x-twitter-profile-editor-8293108a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eoKUjz4O9tq7UVw6TunT1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability twitr-sh-x-twitter-profile-editor-8293108a -d '<json body>'
```

Example prompt: Update the bio on my X account 'myhandle' to 'Building cool things in web3', set the location to 'San Francisco, CA', and change the website to 'https://mysite.com'.

## When to prefer this

Use this endpoint when you need to programmatically edit an X/Twitter profile (name, bio, location, URL, avatar, or banner) without managing Twitter API credentials or OAuth flows. Ideal for AI agents automating social media profile maintenance, brand refresh campaigns, or multi-account management — especially when paying per-call with USDC via x402 is preferred over subscription API tiers.

## Known failure modes

- Account handle not connected to the paying wallet — returns authorization error
- Invalid or inaccessible media URL for avatar/set_banner action — image fetch fails
- Missing required 'action' field — request rejected with validation error
- X API rate limit hit — may return 429 or service error
- Payment failure if wallet has insufficient USDC balance

## How this service works

Pay-per-call X/Twitter API for AI agents. Read tweets, search, monitor accounts in real time, and post — paid in USDC via x402. No signup, no API keys.

## Output

Returns a JSON object confirming the profile update was applied (updated: true), along with a run ID for tracing and a payment record showing the 0.012 USDC charge processed via x402.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "update_profile: new website URL."
  },
  "name": {
   "type": "string",
   "description": "update_profile: new display name."
  },
  "action": {
   "enum": [
    "update_profile",
    "set_avatar",
    "set_banner"
   ],
   "type": "string",
   "description": "Which profile edit to make."
  },
  "account": {
   "type": "string",
   "description": "A connected X handle owned by this wallet (no @)."
  },
  "location": {
   "type": "string",
   "description": "update_profile: new location."
  },
  "media_url": {
   "type": "string",
   "description": "set_avatar|set_banner: public image URL."
  },
  "description": {
   "type": "string",
   "description": "update_profile: new bio."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "updated": true
   }
  ],
  "runId": "tw_example",
  "payment": {
   "amount": "0.012000",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitr-sh-x-twitter-profile-editor-8293108a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitr.sh](https://www.zero.xyz/host/twitr.sh/llms.txt)