Sign inGet Started
Commencer
Guides
Référence API
SDK
CLI
Base de connaissances
Changelog

Get a media-library asset by ID

GET
/v1/assets/{asset_id}
const asset = await bird.assets.get("ast_01krdgeqcxet5s7t44vh8rt9mg");
console.log(asset.url);
Réponse200
{
  "id": "ast_01krdgeqcxet5s7t44vh8rt9mg",
  "url": "https://us1.assets.birdusercontent.com/6fcy8y6a483sewgnjk2g35y2qz/01krdgeqcxet5s7t44vh8rt9mg/document.pdf",
  "thumbnail_url": null,
  "name": "document.pdf",
  "content_type": "application/pdf",
  "kind": "document",
  "size_bytes": 48210,
  "width": null,
  "height": null,
  "alt_text": null,
  "folder_id": null,
  "deleted_at": null,
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-20T09:14:52Z"
}

Returns one media-library asset. An asset that has been removed from the library is returned with deleted_at set rather than as a missing resource, because its URL keeps serving and messages already sent still reference it.

Paramètres

asset_idstring

ID of the asset.

Contenu de la réponse

created_at
string
obligatoire
updated_at
string
obligatoire
id
string
obligatoire
url
string
obligatoire

The asset's permanent public URL. Safe to embed or link in sent messages; for a document the usable form is a link.

thumbnail_url
nullable string
obligatoire

A small preview of the asset, for rendering a picker or a grid. Intended for your own interfaces rather than for embedding in messages. Null for every kind but image: generating a preview of a video, an audio file, or a document would mean rendering its contents, which the library does not do. Show an icon for the kind instead.

name
string
obligatoire

The asset's display name. Defaults to the uploaded file's name.

content_type
string
obligatoire

The stored file's media type, determined from its contents.

kind
string
obligatoire

The category a media-library asset's type falls into. Use it to group or filter a mixed library.

  • image: covers PNG, JPEG, and GIF.
  • video: covers MP4, WebM, and QuickTime.
  • audio: covers MP3, M4A, Ogg, and WAV.
  • document: covers PDF.

Possible values (may grow over time): image, video, audio, document

size_bytes
integer
obligatoire

The stored file's size in bytes. Images are re-encoded on upload, so for those this can differ from the size of the file you sent. Every other kind is stored byte-for-byte.

width
nullable integer
obligatoire

The stored image's width in pixels. Null for every kind but image.

height
nullable integer
obligatoire

The stored image's height in pixels. Null for every kind but image.

alt_text
nullable string
obligatoire

Default alternative text for the asset. Use it as the starting point for an image description when inserting the asset into content. Updating this field does not update descriptions already copied into saved content.

folder_id
nullable string
obligatoire

The folder the asset is filed in, or null when it sits at the top level of the library. Filing an asset never changes its URL.

deleted_at
nullable string
obligatoire

When the asset was removed from the library, or null if it is still listed. A removed asset keeps serving at its original URL.

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.

Obtenir un guide d'implémentation