---
title: "PUT /v2/me/profile-media/{kind}"
method: PUT
path: "/v2/me/profile-media/{kind}"
tags: ["Social"]
---

# PUT /v2/me/profile-media/{kind}

`PUT /v2/me/profile-media/{kind}`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/me/profile-media/{kind}`
- Auth: HTTP bearer

Uploads a JPEG or PNG profile image of at most 2 MiB. The backend strips metadata and publishes the image only after moderation approves it. Moderation failure is fail-closed. Cover uploads remain disabled. Community media uses the separate authenticated /v2/social-media API.

## Path parameters

- `kind` 'profile', required

## Query parameters

- `expected_profile_version` integer, required

## Request body `image/jpeg`

- string, binary

## Response `200`

Approved profile image published and profile version advanced

- ProfileMediaUpload
  - `kind` 'profile', required
  - `profile_version` integer, required
  - `url` string, uri, required: Backend-owned URL for the approved profile image.

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `422`: The server-owned safety policy rejected the social content before persistence or delivery
- `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

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