---
title: "Decline a pending image share"
method: POST
path: "/pending-image-shares/{pendingShareId}/decline"
tags: ["images"]
---

# Decline a pending image share

`POST /pending-image-shares/{pendingShareId}/decline`

## Request

- Base URL: `https://api.blaxel.ai/v0`
- URL: `https://api.blaxel.ai/v0/pending-image-shares/{pendingShareId}/decline`
- 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/:pendingShareId/decline/post.ts> (a function with typed inputs; its response is checked against the schema)

Declines a pending cross-account image share. Caller must be an admin of the target workspace.

## Response `204`

successfully declined

## Other responses

- `403`: forbidden
- `404`: pending image share not found

---

[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)