Read

list_imported_media

Returns the authenticated creator's card-media library (up to 200 non-trashed items) so an agent can reference media IDs when building or updating cards.

Parameters

Name	Type	Required	Description
outlineId	string	—	The outline to scope the media query to. Omit to default to the authenticated user's own outline. Must be an outline owned by the authenticated user — a foreign `outlineId` returns `NOT_FOUND`.

Response

Field	Type	What it means
outlineId	string	String-cast ID of the resolved outline — confirms which outline the returned media belongs to.
media	MediaListItem[]	Array of up to 200 non-trashed media items in the library. Each item has: `mediaId` (use this to reference media when calling `add_card` or `set_card_cover`), `kind` (media type, e.g. `'image'` or `'video'`), `url` (CDN/serve URL of the asset), `sourceUrl` (original imported URL, e.g. the Instagram post URL it came from), `processingStatus` (current processing state — wait for a non-pending status before using the URL in a card), and `alt` (accessibility alt text for the asset).

Example

Request

json

{
  "outlineId": "42"
}

Response

json

{
  "outlineId": "42",
  "media": [
    {
      "mediaId": 101,
      "kind": "image",
      "url": "https://cdn.outli.ne/media/42/portrait-shoot-01.jpg",
      "sourceUrl": "https://www.instagram.com/p/CxABC123xyz/",
      "processingStatus": "ready",
      "alt": "Golden hour portrait session in the park"
    },
    {
      "mediaId": 107,
      "kind": "video",
      "url": "https://cdn.outli.ne/media/42/reel-behind-the-scenes.mp4",
      "sourceUrl": "https://www.instagram.com/reel/DyXYZ789abc/",
      "processingStatus": "ready",
      "alt": null
    },
    {
      "mediaId": 112,
      "kind": "image",
      "url": null,
      "sourceUrl": "https://www.instagram.com/p/CzDEF456uvw/",
      "processingStatus": "processing",
      "alt": null
    }
  ]
}

When to use

Call this after import_from_instagram or import_from_url to discover which media IDs are available before building or updating cards with add_card or update_card. Also useful at the start of a curation session to audit what raw material already exists in the library before deciding what to import.

Gotchas

Watch out

Hard limit of 200 items — if the library is large, older items may be silently omitted; there is no pagination.
Items with processingStatus other than 'ready' (e.g. 'processing') will have a null or unstable url — don't pass their mediaId to add_card or set_card_cover until status is ready.
Trashed items are excluded server-side; a double filter also runs in-memory, so deleted media never appears even if the DB query returns a stale row.
Passing another user's outlineId is blocked by the IDOR gate (resolveOutlineDoc) and returns NOT_FOUND — it does not silently return an empty array.

← All tools ← MCP Guide