Sign inGet Started

List editable resources that use an asset

GET
/v1/assets/{asset_id}/references
const references = await bird.assets.references.list(
  "ast_01krdgeqcxet5s7t44vh8rt9mg",
);
console.log(references.data, references.truncated);
Odpowiedź200
{
  "data": [
    {
      "resource_type": "email_template",
      "resource_id": "emt_01j9zyq8k7f0ra2m6c4x5w8pv3",
      "usage": "draft"
    }
  ]
}

Returns editable resources that reference this asset. Each entry indicates whether the reference appears in the resource's draft, published version, or both. Results reflect the latest saved versions, so they exclude unsaved editor changes and older published versions.

Only resources you have permission to read are included. Email-template references require email_management:read in addition to assets:read. Hidden resources do not affect the truncated flag.

Removing an asset does not break existing references because its original URL keeps serving. Use this list to find content that should reference a replacement asset.

Parametry

asset_idstring

ID of the asset.

Treść odpowiedzi

data
array of object
wymagane
Pokaż atrybuty podrzędne
truncated
boolean
wymagane

True when more resources use this asset than one response can carry, so the list is a partial answer. Replace the asset's usages you can see, then list again to find the rest.

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.