{"uid":"cap_eoKUjz4O9tq7UVw6TunT1","slug":"twitr-sh-x-twitter-profile-editor-8293108a","name":"twitr.sh X/Twitter Profile Editor","description":"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.","url":"https://twitr.sh/api/tools/x_profile?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"items":[{"updated":true}],"runId":"tw_example","payment":{"amount":"0.012000","currency":"USD","protocol":"x402"},"duration":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R8uAwl68808lttw0AISx7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Update an X/Twitter account's profile fields — display name, bio, location, website URL, avatar, or banner image — via pay-per-call USDC payment.","exampleAgentPrompt":"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'.","exampleUseCases":[{"title":"Refresh brand bio after product launch","prompt":"Update the bio on my X account 'acmecorp' to 'The all-new Acme 2.0 is live — smarter tools for developers everywhere', and set the website URL to 'https://acme.io/launch'."},{"title":"Set new profile avatar for rebranding","prompt":"Set the avatar for my X account 'designstudio' to the image at 'https://cdn.designstudio.com/new-logo-2024.png'."},{"title":"Update Twitter banner for a campaign","prompt":"Change the banner image on my X account 'campaignaccount' to the image at 'https://assets.campaign.org/banner-summer2024.jpg'."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T00:34:00.817Z","isFirstParty":false,"canonicalSlug":"twitr-sh-x-twitter-profile-editor-8293108a"}