---
title: "Accept a backup share offered to this space"
method: POST
path: "/spaces/{spaceId}/backup-shares/{shareId}/accept"
tags: ["Backups"]
---

# Accept a backup share offered to this space

`POST /spaces/{spaceId}/backup-shares/{shareId}/accept`

## Request

- Base URL: `https://krova.cloud/api/v1`
- URL: `https://krova.cloud/api/v1/spaces/{spaceId}/backup-shares/{shareId}/accept`
- Auth: API key in header `X-API-KEY`

Requires an API key of this space's owner, or of a member with `backup.manage`. Creates this space's own copy of the backup, billed for storage from now. Refused with 422 when the space cannot take it (no card, unverified owner, open abuse notice, no credit, or no backup allowance left on its plan).

## Path parameters

- `spaceId` string, required
- `shareId` string, required

## Response `200`

The share and the new copy

- object
  - `share` BackupShare, required
    - `id` string, required
    - `status` 'pending' | 'accepted' | 'declined' | 'canceled' | 'expired', required
    - `backupId` string, required: The SOURCE backup being shared.
    - `backupName` string, required
    - `sourceSpaceId` string, required
    - `destinationSpaceId` string, required
    - `counterpartySpaceName` string, required: The other space in this share: the destination on an outgoing share, the source on an incoming one.
    - `copyBackupId` string, nullable, required: The destination space's own copy, once the share is accepted.
    - `expiresAt` string, date-time, required
    - `createdAt` string, date-time, required
  - `backup` Backup, required
    - `id` string, required
    - `name` string, required
    - `status` 'pending' | 'creating' | 'complete' | 'failed', required
    - `originalCubeId` string, required
    - `originalCubeName` string, required
    - `sizeBytes` integer, nullable, required
    - `diskSizeGb` integer, required
    - `config` object, required: The Cube configuration captured with the backup, used by redeploy. A shared copy carries no domains.
      - `vcpus` number, nullable, required
      - `ramMb` integer, nullable, required
      - `diskLimitGb` integer, nullable, required
      - `imageId` string, nullable, required
      - `regionId` string, nullable, required
      - `regionName` string, nullable, required
      - `domains` object[], required
        - `domain` string, required
        - `port` integer, required
      - `tcpPorts` object[], required
        - `cubePort` integer, required
        - `label` string, nullable, required
    - `sharedFromBackupId` string, nullable, required: Set on a shared copy: the backup it was shared from, which may since have been deleted. Null for a backup this space made itself.
    - `redeployedCubeId` string, nullable, required
    - `completedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required

## Other responses

- `403`: Authenticated but lacks the required permission
- `409`: The request is no longer pending, has expired, or this space already has a copy
- `422`: This space cannot take the copy right now
- `429`: Rate limit exceeded (10 mutations / 60s)

---

[API](https://skmtc.dev/krova/apis/krova-cloud-api.md) · [All operations](https://skmtc.dev/krova/apis/krova-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/krova/apis/krova-cloud-api/revisions/46bb68281ce1?raw)