v2

latestOpenAPI 3.1.02026-07-2675166192.8 KB
Images

List User Images

List images and builds for the current user, scoped by team context. Returns personal images by default, or team images if teamId is provided.

Pagination note: limit, offset, and totalCount count logical images (unique owner/imageName:imageTag). A single image may produce multiple data[] rows (one per artifact type plus any active builds), so len(data) can exceed limit and totalCount reflects images, not rows.

The optional search parameter narrows results (case-insensitively) to images whose name, tag, or name:tag reference contains the given substring.

Setting ownerScope=platform lists only org-less platform images and builds; this requires platform admin access.

get/api/v1/images

Query parameters

teamIdstring nullable

Filter by team ID. If provided, returns only that team's images. If not provided, returns only personal images.

Filter by team ID. If provided, returns only that team's images. If not provided, returns only personal images.

searchstring nullable

Case-insensitive substring match on image name, tag, or the displayed reference.

Case-insensitive substring match on image name, tag, or the displayed reference.

ownerScope'team' | 'personal' | 'platform'

Set to platform to list org-less platform images (platform admins only).

offsetinteger
limitinteger

Response

Successful Response

total_countinteger

Total number of items available in the dataset

offsetinteger

Number of items to skip before starting to collect the result set

limitinteger

Maximum number of items to return

statusstring nullable

Response status