# Palmyr Twitter Avatar Update

> Palmyr Twitter Avatar Update is a paid API for AI agents from palmyr.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Updates the avatar (profile picture) image of an X (Twitter) account you control, returning an async operation to poll for completion.

## Facts

- Endpoint: POST https://palmyr.ai/social/twitter/avatar
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/palmyr-twitter-avatar-update-8f146ebc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mzAhpTho0yexyBvVeKeCg

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 palmyr-twitter-avatar-update-8f146ebc -d '<json body>'
```

Example prompt: Update the profile picture on my X account to this new image — swap out my current avatar with the logo I just generated.

## When to prefer this

Use this endpoint when you need to programmatically update the avatar/profile image of an X (Twitter) account you own, especially in agentic workflows where the change is triggered by automation (e.g., rotating brand avatars, deploying AI-generated profile images). Prefer this over manual Twitter UI changes when operating at scale or within an autonomous agent pipeline. Payment is handled via x402 with USDC, making it suitable for crypto-native agent stacks.

## Known failure modes

- Invalid or expired X account credentials — returns authentication error
- Image format or size not supported by X — returns validation error
- X API rate limit hit — returns rate limiting error
- Network timeout on async job start — operation ID may not be returned
- Image URL unreachable or inaccessible — returns fetch error
- Insufficient USDC balance for x402 payment — returns payment error

## How this service works

Update the avatar image of an X account you control. Async: returns an operation to poll.

## Output

Returns an asynchronous operation object containing an operation ID and a polling endpoint, which the agent can query to check whether the avatar update has completed successfully on the X platform.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "properties": {
    "body": {
     "type": "object",
     "additionalProperties": true
    }
   }
  },
  "output": {
   "properties": {
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/palmyr-twitter-avatar-update-8f146ebc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from palmyr.ai](https://www.zero.xyz/host/palmyr.ai/llms.txt)