---
title: "Set the artist picture"
method: POST
path: "/api/v1/artists/{artist_id}/picture"
tags: ["artists"]
---

# Set the artist picture

`POST /api/v1/artists/{artist_id}/picture`

## Request

- Base URL: `https://kinetune.com`
- URL: `https://kinetune.com/api/v1/artists/{artist_id}/picture`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://kinetune.com/api/auth/oauth2/authorize`, token URL `https://kinetune.com/api/auth/oauth2/token`, scopes: `music:write`, `videos:write`)

Choose which photo is the artist’s picture, and how it is cropped to a square

The picture (image_url on the artist, a 512 px square) is cut from one of the artist’s photos; the photo itself is unchanged. The first photo becomes the picture automatically, centered. crop is in fractions of the photo (its url): x/y the top-left corner, size the side relative to the photo’s short side; leave it out to center.

## Path parameters

- `artist_id` string, required: The artist id

## Request body

- object
  - `photo_id` string, required: One of the artist’s photos (list_artist_photos)
  - `crop` object: The square to keep, in fractions of the photo; centered when omitted
    - `x` number, required
    - `y` number, required
    - `size` number, required

## Response `200`

OK

## Other responses

- `201`: Created
- `400`: Invalid request
- `401`: Missing or invalid credentials
- `402`: Not enough credits
- `403`: Missing scope
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable
- `503`: Temporarily unavailable (AI video): nothing was held; try again after Retry-After seconds

---

[API](https://skmtc.dev/kinetune/apis/kinetune-api.md) · [All operations](https://skmtc.dev/kinetune/apis/kinetune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinetune/apis/kinetune-api/revisions/372c8e87d1ff?raw)