> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anchorage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlas delegations

> Reserve assets in your custody vault for a counterparty without moving them, and settle assets in and out of the delegation by API.

A delegation reserves assets held in one Atlas participant's vault for another participant, under an agreement the two have signed. The assets stay in the owner's Anchorage Digital custody vault. A hold stops them from being moved except as the agreement allows, and Anchorage Digital enforces those terms as a neutral custodian.

## Parties

| Party | Who it is | In the API |
| :- | :- | :- |
| Delegator | The participant whose vault holds the assets: the borrower, or the trader. Also called the pledgor. | `delegatorId` |
| Delegatee | The participant the assets are reserved for: the lender, or the exchange. Also called the secured party. | `delegateeId` |
| Custodian | Anchorage Digital. Holds the assets and enforces the agreement's terms. | |

Both parties are Atlas participants. See [Atlas](https://docs.anchorage.com/knowledge-base/platform/users/atlas-network.md) for creating participants and sharing their IDs.

## What a delegation contains

* `vaultUniqueId`: the delegator's vault that holds the delegated assets. Only the delegator sees it.
* `delegatedAssets`: one entry per delegated asset holding, with the amount currently delegated. Amounts never include fees. For the delegator, each entry also has `walletUniqueId`, the wallet that holds it. The delegatee does not see vault or wallet IDs.
* `sourceAddresses` on each asset: the on-chain addresses currently holding it. The delegator always sees them. The delegatee sees them only if the pledgor has opted in to disclosing them. Assets can move between addresses over time, but they stay in the delegator's wallet. An empty list means the asset has no attributable on-chain address, for example fiat.
* `revokedOn`: set once the delegation has ended. Absent while it is active.

In the delegator's balances, delegated assets appear as **Held for Atlas delegation**. See [Reading balances](https://docs.anchorage.com/knowledge-base/platform/users/reading-balances.md).

## Settling assets in and out

Either party can propose moving assets between a wallet its organization owns and the delegation, within the agreement's settle rights.

1. Call `POST /atlas/delegations/{delegationId}/settle` with one entry per wallet and asset, plus an `idempotentId` so a retried request is not applied twice. `clientReferenceId` is an optional memo both parties see. A positive quantity is an asset your wallet receives; a negative quantity is an asset your wallet sends. Every entry in one request points the same way. An asset can be received into only one wallet, but can be sent from several.
2. The request returns `202` with a `settlementRequestId` once it is accepted for processing. Nothing has moved yet.
3. The delegator approves the settlement, whichever party proposed it. Assets move only after that approval.

Assets settled into the delegation land in the delegator's wallet for that asset in the delegation's vault, and the delegation grows by that amount. Assets settled out leave the delegation and arrive in the receiving wallet.

## Permissions

| Endpoint | Permission |
| :- | :- |
| `GET /atlas/delegations`, `GET /atlas/delegations/{delegationId}` | Read vault activity |
| `POST /atlas/delegations/{delegationId}/settle` | Propose and Accept settlements, with [request signing](https://docs.anchorage.com/knowledge-base/platform/developers/request-signing.md) |


## Related topics

- [List delegations](https://docs.anchorage.com/knowledge-base/api-reference/v2/atlas-general-delegation/list-delegations.md)
- [Get a delegation by ID](https://docs.anchorage.com/knowledge-base/api-reference/v2/atlas-general-delegation/get-a-delegation-by-id.md)
- [Propose settling assets out of a delegation](https://docs.anchorage.com/knowledge-base/api-reference/v2/atlas-general-delegation/propose-settling-assets-out-of-a-delegation.md)
- [Atlas](https://docs.anchorage.com/knowledge-base/platform/users/atlas-network.md)
- [Reading balances](https://docs.anchorage.com/knowledge-base/platform/users/reading-balances.md)
