Receive audios

Retrieves audio messages sent to an assistant since a given timestamp. Optionally filters by sender. The receiver’s token is passed in the body.

POST /receive-audio

Error

A valid request URL is required to generate request examples

200

[
  {
    "media_id": 1,
    "sender_id": 201,
    "receiver_id": 101,
    "media_path": "http://example.com/media/image1.jpg",
    "sent_at": "2024-06-21 15:30:00",
    "sender_name": "Mobile User One",
    "sender_image": "http://example.com/mobile_user_image.jpg",
    "type": "image"
  }
]

Body

application/json

token · string · required

JWT Access Token of the receiver (assistant user).

Example:

"eyJ..."

from_timestamp · string<date-time> · required

Timestamp (UTC) from which to retrieve new media (YYYY-MM-DD HH:MM:SS).

Example:

"2024-01-01 00:00:00"

sender_user_id · integer | null

Optional: Filter media by a specific sender user ID.

Example:

201

Response

200

application/json

List of received audio messages.

media_id · integer

Example:

1

sender_id · integer

Example:

201

receiver_id · integer | null

Example:

101

media_path · string

Example:

"http://example.com/media/image1.jpg"

sent_at · string<date-time>

Local time (Europe/Madrid).

Example:

"2024-06-21 15:30:00"

sender_name · string

Example:

"Mobile User One"

sender_image · string | null

Example:

"http://example.com/mobile_user_image.jpg"

type · enum<string>

Available options: audio, image

Example:

"image"