app.bsky.embed.getEmbedExternalView

Resolve one AT-URI record into the data needed to render an enhanced external embed. The records are validated against the requested `url` before any view is built. When validation passes, returns `data`, `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`, plus a legacy `view` for Standard.site records only. When validation fails, only `unverifiedAssociatedRefs` and `unverifiedAssociatedRecords` are returned and no view or data is built. The response is empty (`{}`) when no record URI was usable or the record could not be resolved; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.

Repository @bsky-lexicons.bsky.social did:plc:4v4y5r3lwsbtmsxhile2ljac namespace authority

Details · query

Kind	query
Authority	embed.bsky.app
Indexed	24d ago · 2026-10-17

Compare Edit in builder → Fork →

What's different

same NSID · two revisions from the same publisher

5 changes, 1 breaking

Some records or requests that were valid against the base schema aren't valid against this one, so update the code that writes and reads them before relying on it.

Query · parameters

#main

Added

canonicalUri

compatible

New optional parameter.

string · at-uri

Changed

uris

breaking

Became optional.

~~required~~→optional

Query · output

#main

Added

data

compatible

New optional property.

union

Added

unverifiedAssociatedRecords

compatible

New optional property.

array of unknown

Added

unverifiedAssociatedRefs

compatible

New optional property.

array of ref

4 properties unchanged Open the full schema diff →