---
title: "Changes to Hand a deleted agent's card to an agent"
method: POST
path: "/agents/{agentId}/card-handover"
---

# Changes to Hand a deleted agent's card to an agent

`POST /agents/{agentId}/card-handover`

> Every recorded change to this operation, newest first.
> 116 revisions in range; 2 not diffed.

## Timeline

Changed in 5 of 116 revisions.

- **2026-11-02** `e3a3f79a161f`: 1 info
- **2026-10-28** `d996ddfb9d2b`: 5 info
- **2026-10-28** `5abf2bb56bcb`: 1 warning
- **2026-10-27** `5fbda612feb8`: 6 breaking, 1 info
- **2026-10-26** `e4de0e70d752`: 1 info

## Changes

- **2026-11-02** `e3a3f79a161f`: 1 info
  - added the new optional `query` request parameter `kind`
- **2026-10-28** `d996ddfb9d2b`: 5 info
  - added the optional property `details/missingFields` to the response with the `400` status
  - added the optional property `details/permission` to the response with the `403` status
  - added the optional property `details/policyDenialReason` to the response with the `403` status
  - added the optional property `details/refusalReason` to the response with the `400` status
  - added the optional property `details/refusalReason` to the response with the `403` status
- **2026-10-28** `5abf2bb56bcb`: 1 warning
  - added the new `CORRIDOR_UNDER_MAINTENANCE` enum value to the `code` response property for the response status `403`
- **2026-10-27** `5fbda612feb8`: 6 breaking, 1 info
  - removed the required property `cardCapabilities/supportsSpendLimits` from the response with the `200` status
  - removed the required property `cardCapabilities/supportsSpendLimitsAtIssuance` from the response with the `200` status
  - removed the required property `cardCapabilities/supportsTransactionCountLimit` from the response with the `200` status
  - removed the required property `maxSpendPerDay` from the response with the `200` status
  - removed the required property `maxSpendPerTransaction` from the response with the `200` status
  - removed the required property `maxTransactionsPerDay` from the response with the `200` status
  - added the required property `cardCapabilities/supportsVelocityLimits` to the response with the `200` status
- **2026-10-26** `e4de0e70d752`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/lightsparkdev/apis/grid-api/docs/agents/:agentId/card-handover/post.md) - [API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) - [Page](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/agents/:agentId/card-handover/post)