Get a file

A file, with a fresh url that reads it for an hour.

Needs a key with the messages:read scope. Keys and scopes

Path parameters

• idstringrequired

  The file’s id.

  Starts with file_.

Example

curl "https://usebluebot.com/api/v1/files/file_1Hq2LxW9cVbN3mKpRtYs0a" \
  -H "Authorization: Bearer $BLUEBOT_API_KEY"

Response

200: The file.

• idstringrequired

  A file_ id.

  Starts with file_.

• object"file"required
• namestring or nullrequired

  The file name, as it was uploaded or as Messages named it.

• content_typestringrequired

  The media type.

• sizeintegerrequired

  Bytes.

• kindstringrequired

  What the file is, for showing it: an image, a video, audio, a voice memo, a PDF, a contact card or another file.

  One of image, video, audio, voice_memo, pdf, contact_card, file.

• statusstringrequired

  ready when BlueBot has the bytes; waiting while the Mac uploads them (usually seconds); too_large for an attachment over 25 MB, which the Mac never uploads; deleted once 30 days have passed.

  One of ready, waiting, too_large, deleted.

• urlstring or nullrequired

  Reads the file for an hour. Null unless status is ready.

• url_expires_attimestamp or nullrequired

  When url stops working.

• transcriptstring or nullrequired

  For a voice memo, the words the Mac transcribed on the device, when the owner turned transcription on.

• transcript_languagestring or nullrequired

  The transcript’s language, such as en-US.

• created_attimestamprequired

  When BlueBot first knew of the file.

{
  "id": "file_1Hq2LxW9cVbN3mKpRtYs0a",
  "object": "file",
  "name": "listing-412-oak.jpg",
  "content_type": "image/jpeg",
  "size": 482113,
  "kind": "image",
  "status": "ready",
  "url": "https://usebluebot.com/files/f/2Bf8QzD4kJmA6nXwEuTr1c?sig=…",
  "url_expires_at": "2026-11-13T20:41:00.000Z",
  "transcript": null,
  "transcript_language": null,
  "created_at": "2026-11-13T19:40:00.000Z"
}

Errors

Every refusal has the same envelope and a page of its own. These are the ones this operation can give.

Try it