Complete an avatar upload

POST

/v1/me/avatar/{id}/complete

const url = 'https://app.mondochat.io/v1/me/avatar/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/complete';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://app.mondochat.io/v1/me/avatar/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/complete \
  --header 'Authorization: Bearer <token>'

Finishes the avatar upload. Takes a session token. The photo has kind avatar and status held until photo moderation approves it; then it is the user’s avatar and wins over the avatar your server sent. See https://docs.mondochat.io/guides/media/.

Authorizations

session

Parameters

Path Parameters

required

string format: uuid

Responses

200

Successful Response

application/json

Photo

A photo, video, voice note or avatar and the links to read it.

object

full_url

required

Any of:

string
null

string

height

required

Any of:

integer
null

integer

required

The media’s id.

string format: uuid

kind

required

Kind

What the media is.

string

Allowed values: photo video voice avatar

status

required

Status

pending until the upload is completed, held while it waits for the receiver’s consent or for moderation, rejected or deleted once it is gone.

string

Allowed values: pending ready held rejected deleted

thumb_url

required

Any of:

string
null

string

uploader_id

required

Uploader Id

The id of the user who uploaded it.

string format: uuid

width

required

Any of:

integer
null

integer

Example

{
  "full_url": "https://media.example.test/p/0199d6a0-4000-7000-8000-000000000001/full.webp",
  "height": 2048,
  "id": "0199d6a0-4000-7000-8000-000000000001",
  "kind": "photo",
  "status": "ready",
  "thumb_url": "https://media.example.test/p/0199d6a0-4000-7000-8000-000000000001/thumb.webp",
  "uploader_id": "0199d6a0-1000-7000-8000-000000000001",
  "width": 1536
}

4XX

Problem

application/problem+json

An RFC 9457 problem: the body of every error answer.

object

code

required

The stable error code to branch on, such as policy_denied.

string

detail

What went wrong this time, when there is more to say.

string | null

errors

For validation, one entry per invalid field.

Array<object>

One invalid field.

object

loc

The path to the field.

array

msg

What is wrong with it.

string

instance

The path of the request.

string

reason

For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.

string

status

required

The HTTP status code.

integer

title

required

A short summary of the problem.

string

type

required

A URL that names the problem, https://app.mondochat.io/problems/<code>.

string

Example

{
  "code": "policy_denied",
  "detail": null,
  "instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001",
  "reason": "pins",
  "status": 403,
  "title": "Policy denied",
  "type": "https://app.mondochat.io/problems/policy_denied"
}