iblai-api-catalog-medialisted
Install: claude install-skill iblai/api
# iblai-api-catalog-media
Manage an organization's **catalog media resources** from the API: media files
and external links (videos, images, documents, audio, other) attached to a
course, a unit, a specific resource item, or any combination of the three.
Supports listing/filtering, full CRUD, a search action, and a by-item lookup.
The `item_type` (which catalog level the media is associated with) is derived
automatically from which of `course_id` / `unit_id` / `item_id` you supply.
Use when attaching media to catalog content, browsing/searching an org's media,
or uploading media files.
## Auth & conventions
- **Base URL:** `https://api.iblai.app/dm` — these are Data Manager (DM)
endpoints, so the **`/dm` prefix is required**; the
`/api/media/orgs/{org}/users/{user_id}/media/media-resources/...` paths below
are appended to it (e.g.
`https://api.iblai.app/dm/api/media/orgs/enterprise/users/36/media/media-resources/`).
- **Header:** `Authorization: Api-Token $IBLAI_API_KEY` on every request.
- **Path vars:** `{org}` = `$IBLAI_ORG` (the org key — matched against the
platform's `org`), `{user_id}` = the **numeric** user id (matched against
`User.id`; this is not the username). Both org and user are baked **into the
path** here (unlike most catalog endpoints, which pass them as params).
- **Auth classes:** session, OAuth2 client-credential, and platform Api-Token.
- DELETE / destructive / outward-facing calls (delete, file upload) say
"Confirm with the user first