List publish access records

GET

https://api.dsx-air.nvidia.com/api/v3/publishing/publish-access-records/

GET

/api/v3/publishing/publish-access-records/

curl https://api.dsx-air.nvidia.com/api/v3/publishing/publish-access-records/ \
     -H "Authorization: Bearer <token>"

{
  "count": 123,
  "results": [
    {
      "id": "string",
      "created": "2024-01-15T09:30:00Z",
      "modified": "2024-01-15T09:30:00Z",
      "type": "string",
      "resource_id": "string",
      "resource_name": "string",
      "resource_version": "string",
      "requested_by": "string",
      "requesting_org": "string",
      "requesting_org_display_name": "string",
      "requesting_org_ngc_org_name": "string",
      "reviewed_by": "string",
      "status": "PENDING",
      "publicly_published": true,
      "prefer_public": true,
      "justification": "string",
      "allowed_orgs_request_text": "string",
      "denial_reason": "string",
      "requested_at": "2024-01-15T09:30:00Z",
      "reviewed_at": "2024-01-15T09:30:00Z"
    }
  ],
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100"
}

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)

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

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

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