# Change hopper image

`POST https://api.cryptohopper.com/v1/hopper/{id}/changeimage`

Part of [Hoppers](https://www.cryptohopper.com/api-documentation/api-reference/hoppers.md) in the Cryptohopper API reference.

Replaces the hopper image. The image is cropped to 600 by 430 pixels, saved as JPEG and its new URL is returned.

Send image as a base64 encoded image file.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Hopper ID. |

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `image` | string | yes |  |

## Example request

```bash
curl -X POST "https://api.cryptohopper.com/v1/hopper/HOPPER_ID/changeimage" \
  -H "access-token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image":"/9j/4AAQSkZJRgABAQAAAQABAAD..."}'
```

## Response

Example response (illustrative values):

```json
{
    "data": "https://cdn.cryptohopper.com/images/hoppers/hoppers/123456_2026-09-25-10-15-00.jpg"
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.