Skip to navigation
Air APIAPI ReferencePublishing

List publish access records

View as Markdown

List image and marketplace demo publish access records visible to your account in a single paginated response. Rows are gated by type-specific scopes (IMAGE_WRITE / IMAGE_PUBLISH for images; MARKETPLACE_DEMO_WRITE / MARKETPLACE_DEMO_PUBLISH for demos). Air administrators and SREs see all records of the types they can read; others see only records from their organization.

Required scopes (any one):

  • air:image_write (roles: air_image_publisher, air_image_uploader)
  • air:image_publish (roles: air_image_publisher)
  • air:marketplace_demo_write (roles: air_demo_manager, air_org_admin, air_user)
  • air:marketplace_demo_publish (roles: air_demo_manager)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional
Number of results to return per page.
offsetintegerOptional
The initial index from which to return the results.
orderingenumOptional

Order objects by field. Prefix with - for descending order.

publicly_publishedbooleanOptional

Filter by public vs restricted visibility (for approved requests).

requested_by_emailstringOptional

Filter by requester email (case-insensitive).

requesting_org_display_namestringOptional

Filter by requesting organization display name (case-insensitive).

requesting_org_ngc_org_namestringOptional

Filter by requesting organization NGC name (case-insensitive).

resource_idstringOptionalformat: "uuid"
Filter by image or marketplace demo resource UUID.
searchstringOptional

Search by resource_name, resource_version, justification, allowed_orgs_request_text, requested_by_email, requesting_org_display_name, or requesting_org_ngc_org_name.

statusenumOptional

Filter by request status.

  • PENDING - Pending
  • APPROVED - Approved
  • DENIED - Denied
  • REMOVED - Removed
  • CANCELLED - Cancelled
  • PENDING_ELEVATION - Pending Elevation
  • PENDING_RESTRICTION - Pending Restriction
  • PENDING_UNPUBLISH - Pending Unpublish
  • PENDING_ALLOWLIST - Pending Allow List Change
  • APPROVED_PENDING_IMAGE_PUBLISH - Approved Pending Image Publish
typeenumOptional

Filter by publish access record type.

  • image - Image
  • marketplace-demo - Marketplace Demo
Allowed values:

Response

countinteger
resultslist of objects
nextstring or nullOptionalformat: "uri"
previousstring or nullOptionalformat: "uri"

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error