> ## Documentation Index > Fetch the complete documentation index at: https://docs.baseten.co/llms.txt > Use this file to discover all available pages before exploring further. # List image tags > Lists a page of tags for a sandbox image. Use this endpoint to retrieve versions separately from image repository summaries. The default sort uses tag names, so the first item isn't necessarily the newest version. Follow the pagination cursor while `pagination.has_more` is `true`. Filter by exact `name` or case-sensitive prefix `q`, but don't combine them. Use a returned tag to [select a version](/sandboxes/manage-images#use-an-image-in-a-sandbox). ## OpenAPI ````yaml get /v1/sandboxes/images/{image_name}/tags openapi: 3.1.0 info: description: REST API for management of Baseten resources title: Baseten management API version: 1.0.0 servers: - url: https://api.baseten.co security: - BearerAuth: [] paths: /v1/sandboxes/images/{image_name}/tags: parameters: - $ref: '#/components/parameters/SandboxImageName' get: tags: - Images summary: List image tags description: Return one cursor-paginated page of image versions. operationId: ListImageTags parameters: - $ref: '#/components/parameters/TeamId' - $ref: '#/components/parameters/TeamIdHeader' - $ref: '#/components/parameters/Cursor' - $ref: '#/components/parameters/Limit' - name: sort in: query description: >- Sort by tag name: name:asc or name:desc. Keep the same sort when following a cursor. schema: type: string default: name:asc - name: q in: query description: >- Case-sensitive tag name prefix. Cannot be combined with name. Forces ascending name order. schema: type: string - name: name in: query description: >- Exact tag name. Cannot be combined with q. Forces ascending name order. schema: type: string responses: '200': description: Successful operation. content: application/json: schema: $ref: '#/components/schemas/ListSandboxImageTagsResponseV1' '400': $ref: '#/components/responses/SandboxError400' '401': $ref: '#/components/responses/SandboxError401' '403': $ref: '#/components/responses/SandboxError403' '404': $ref: '#/components/responses/SandboxError404' '429': $ref: '#/components/responses/SandboxError429' '500': $ref: '#/components/responses/SandboxError500' components: parameters: SandboxImageName: name: image_name in: path required: true description: Image repository name. schema: type: string minLength: 1 example: base-image TeamId: name: team_id in: query required: false description: >- Optional team ID. Must match X-Team-Id when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden. schema: minLength: 1 type: string TeamIdHeader: name: X-Team-Id in: header required: false description: >- Optional team ID. Must match the team_id query parameter when both are supplied. If neither selector is supplied, defaults to the caller's only accessible team. Callers with multiple accessible teams must select a team. Requests without access to any team are forbidden. schema: minLength: 1 type: string Cursor: name: cursor in: query required: false description: Opaque cursor from the previous page; omit for the first page. schema: type: string example: >- eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ Limit: name: limit in: query required: false description: Maximum number of items to return. schema: type: integer minimum: 1 maximum: 100 default: 20 example: 20 schemas: ListSandboxImageTagsResponseV1: type: object description: One page of image tags. properties: items: type: array items: $ref: '#/components/schemas/SandboxImageTagV1' pagination: $ref: '#/components/schemas/SandboxApiPaginationV1' required: - items - pagination SandboxImageTagV1: type: object description: A tag identifying a version of a sandbox image. properties: name: type: string description: Image tag name. example: latest created_at: type: string description: Time the tag was created. format: date-time readOnly: true example: '2026-09-16T21:20:00Z' updated_at: type: string description: Time the tag was last updated. format: date-time readOnly: true example: '2026-09-16T21:25:00Z' size: type: integer description: Image size in bytes. format: int64 minimum: 0 readOnly: true example: 134217728 required: - name example: name: latest created_at: '2026-09-16T21:20:00Z' updated_at: '2026-09-16T21:25:00Z' size: 134217728 SandboxApiPaginationV1: type: object description: >- Cursor pagination information. The cursor is present only when another page is available. properties: has_more: type: boolean description: Whether another page is available. example: true cursor: type: string description: >- Opaque cursor to pass to the next list request. Keep the same filters. minLength: 1 example: >- eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ required: - has_more example: has_more: true cursor: >- eyJ2IjoxLCJsYXN0X2tleSI6ImJhc2V0ZW4tYXBpLXJldmlldy0wOTE2Iiwic29ydCI6ImRlc2MifQ responses: SandboxError400: description: >- Invalid request. Returns a JSON error with code, message, and optional details. content: application/json: example: code: INVALID_REQUEST message: One or more request parameters are invalid. details: request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043 SandboxError401: description: >- Missing or invalid authentication. Returns a JSON error with code, message, and optional details. content: application/json: example: code: UNAUTHORIZED message: Provide a valid authentication token in the Authorization header. details: header: Authorization SandboxError403: description: >- Insufficient permissions. Returns a JSON error with code, message, and optional details. content: application/json: example: code: FORBIDDEN message: >- This authentication token does not grant permission to perform this operation. details: request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043 SandboxError404: description: >- Resource not found. Returns a JSON error with code, message, and optional details. content: application/json: example: code: NOT_FOUND message: The requested resource was not found. details: request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043 SandboxError429: description: >- Request limit exceeded. Returns a JSON error with code, message, and optional details. content: application/json: example: code: RATE_LIMITED message: Too many requests. Try again in 30 seconds. details: retry_after_seconds: 30 SandboxError500: description: >- Internal server error. Returns a JSON error with code, message, and optional details. content: application/json: example: code: INTERNAL_ERROR message: The request could not be completed. Try again later. details: request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043 securitySchemes: BearerAuth: type: http scheme: bearer description: >- Send `Authorization: Bearer `. The legacy `Authorization: Api-Key ` scheme is also accepted. ````