---
title: "List pending image shares"
method: GET
path: "/pending-image-shares"
tags: ["images"]
---

# List pending image shares

`GET /pending-image-shares`

## Request

- Base URL: `https://api.blaxel.ai/v0`
- URL: `https://api.blaxel.ai/v0/pending-image-shares`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Client credentials
    - Token URL: `/oauth/token` scopes: `images:share`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blaxel/apis/blaxel-control-plane/docs/pending-image-shares/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists pending cross-account image shares targeting the caller's workspace (incoming) or originating from it (outgoing). Expired shares are cleaned up opportunistically.

## Query parameters

- `direction` 'incoming' | 'outgoing'

## Response `200`

successful operation

- PendingImageShareRender[]
  - `createdAt` string: Creation date
  - `expiresAt` string: Expiration date
  - `hasConflict` boolean: Whether the target workspace already has an image with the same name (potential conflict)
  - `id` string: Unique identifier for the pending image share
  - `imageName` string: Image name (repository)
  - `resourceType` string: Resource type (agent, function, sandbox, job)
  - `sharedBy` string: User sub who initiated the share
  - `sharedByEmail` string: Email of the user who initiated the share
  - `sourceAccountId` string: Source account ID
  - `sourceWorkspace` string: Source workspace name
  - `sourceWorkspaceDisplayName` string: Source workspace display name
  - `targetAccountId` string: Target account ID
  - `targetWorkspace` string: Target workspace name
  - `targetWorkspaceDisplayName` string: Target workspace display name

---

[API](https://skmtc.dev/blaxel/apis/blaxel-control-plane.md) - [All operations](https://skmtc.dev/blaxel/apis/blaxel-control-plane/llms.txt) - [OpenAPI document](https://skmtc.dev/blaxel/apis/blaxel-control-plane/revisions/dfa264bc72ee?raw)