List the photos of a conversation

GET

/v1/conversations/{id}/photos

const url = 'https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/photos?limit=50';
const options = {method: 'GET', 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 GET \
  --url 'https://app.mondochat.io/v1/conversations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/photos?limit=50' \
  --header 'Authorization: Bearer <token>'

Lists the photos and videos of a conversation the caller can see, newest first, one page at a time. View-once media and voice notes are never listed. Takes a session token. Call it again to get fresh links for media whose link failed. See https://docs.mondochat.io/guides/media/.

Authorizations

session

Parameters

Path Parameters

required

string format: uuid

Query Parameters

cursor

Any of:

string
null

string

limit

Limit

integer

default: 50 >= 1 <= 200

Responses

200

Successful Response

application/json

Page[Photo]

One page of a list, with a cursor for the next page.

object

items

required

Items

The entries on this page.

Array<object>

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

next_cursor

Any of:

string
null

string

Example

{
  "items": [
    {
      "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"
}