> ## Documentation Index
> Fetch the complete documentation index at: https://docs.primeintellect.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk Update Image Visibility

> Publish or unpublish many images at once in the current personal or team context.

Provide either explicit `images` references or a `search` filter (same
semantics as the list endpoint's `search`). Names are matched literally
within the caller's personal scope, or the team scope when `teamId` is
set; owner-prefixed references are not supported here. Explicit
references report not-found and permission failures per image, while
`search` only updates the images the caller is allowed to change.

## Rate Limit

50 requests per 60 seconds per IP and token.


## OpenAPI

````yaml https://api.primeintellect.ai/openapi.json patch /api/v1/images/visibility
openapi: 3.1.0
info:
  title: PI API
  version: 0.1.0
servers:
  - url: https://api.primeintellect.ai
security: []
paths:
  /api/v1/images/visibility:
    patch:
      tags:
        - Images
      summary: Bulk Update Image Visibility
      description: >-
        Publish or unpublish many images at once in the current personal or team
        context.


        Provide either explicit `images` references or a `search` filter (same

        semantics as the list endpoint's `search`). Names are matched literally

        within the caller's personal scope, or the team scope when `teamId` is

        set; owner-prefixed references are not supported here. Explicit

        references report not-found and permission failures per image, while

        `search` only updates the images the caller is allowed to change.
      operationId: bulk_update_image_visibility_api_v1_images_visibility_patch
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkUpdateImageVisibilityRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkUpdateImageVisibilityResponse'
        '401':
          description: Authorization failed
        '422':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    BulkUpdateImageVisibilityRequest:
      properties:
        visibility:
          $ref: '#/components/schemas/ImageVisibilityEnum'
          description: New image visibility (PUBLIC or PRIVATE)
        images:
          anyOf:
            - items:
                $ref: '#/components/schemas/BulkImageVisibilityRef'
              type: array
              maxItems: 100
            - type: 'null'
          title: Images
          description: Explicit image references to update (max 100 per request)
        search:
          anyOf:
            - type: string
            - type: 'null'
          title: Search
          description: >-
            Case-insensitive substring match on image name, tag, or the name:tag
            reference; every matching image in scope is updated
        teamId:
          anyOf:
            - type: string
            - type: 'null'
          title: Teamid
          description: Team ID if updating team images
      type: object
      required:
        - visibility
      title: BulkUpdateImageVisibilityRequest
      description: >-
        Request model for publishing or unpublishing many images at once.


        Exactly one of ``images`` (explicit references) or ``search``
        (server-side

        filter, same semantics as the list endpoint) must be provided. The whole

        request operates in a single owner scope: the caller's personal images
        by

        default, or a team's images when ``teamId`` is set. Owner-prefixed

        references are not supported here; names are matched literally.
    BulkUpdateImageVisibilityResponse:
      properties:
        success:
          type: boolean
          title: Success
          description: True when no image failed to update
        message:
          type: string
          title: Message
          description: Status message describing the result
        visibility:
          $ref: '#/components/schemas/ImageVisibilityEnum'
          description: Requested visibility
        succeeded:
          items:
            type: string
          type: array
          title: Succeeded
          description: name:tag references that were updated
        failed:
          items:
            $ref: '#/components/schemas/BulkImageVisibilityFailure'
          type: array
          title: Failed
          description: References that could not be updated
      type: object
      required:
        - success
        - message
        - visibility
      title: BulkUpdateImageVisibilityResponse
      description: Response model for a bulk image visibility update.
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          title: Errors
      type: object
      required:
        - errors
      title: ErrorResponse
    ImageVisibilityEnum:
      type: string
      enum:
        - PRIVATE
        - PUBLIC
      title: ImageVisibilityEnum
    BulkImageVisibilityRef:
      properties:
        name:
          type: string
          minLength: 1
          title: Name
          description: Image name
        tag:
          type: string
          minLength: 1
          title: Tag
          description: Image tag
      type: object
      required:
        - name
        - tag
      title: BulkImageVisibilityRef
      description: One plain image reference (name + tag) inside the request's owner scope.
    BulkImageVisibilityFailure:
      properties:
        image:
          type: string
          title: Image
          description: Image reference as name:tag
        error:
          type: string
          title: Error
          description: Why the update failed
      type: object
      required:
        - image
        - error
      title: BulkImageVisibilityFailure
      description: One image that could not be updated by a bulk visibility request.
    ErrorDetail:
      properties:
        param:
          type: string
          title: Param
        details:
          type: string
          title: Details
      type: object
      required:
        - param
        - details
      title: ErrorDetail
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````