Delegations

Overview

Delegations let your organization grant another organization access to one of your wallets. The grantee can then operate on that wallet — within the permissions you specify — using their own API keys.

This is distinct from API keys, which operate within a single organization. Delegations are cross-organization: you own a wallet, and you authorize a separate org to act on it.

Common use cases:

• Agency model: a marketing agency's AI agents spend from your wallet on your behalf
• Multi-org setups: a parent org delegates spending authority to subsidiary orgs
• Freelancer model: a contractor's agent receives payment access to a client wallet for the duration of a project
• Revenue sharing: a partner org deposits earnings directly into your wallet

Creating a Delegation

POST /v1/delegations

Request Body

import Wallgent from '@wallgent/sdk'

const wg = new Wallgent({ apiKey: process.env.WALLGENT_API_KEY })

const delegation = await wg.delegations.create({
  walletId: 'wal_01J...',
  delegateApiKeyId: 'del_01J...',
  permissions: ['payments:write', 'wallets:read'],
  expiresAt: '2026-06-01T00:00:00Z',
})

console.log('Delegation ID:', delegation.id)

Available Permissions for Delegation

You can delegate any subset of permissions from your own key's permission set. You cannot grant more permissions than you hold.

Listing Delegations

GET /v1/delegations

Returns all delegations your organization has created (delegations you have granted to others).

const { data } = await wg.delegations.list()

for (const d of data) {
  console.log(`Wallet ${d.walletId} → permissions: ${d.permissions.join(', ')} (expires: ${d.expiresAt ?? 'never'})`)
}

Filter Parameters

Revoking a Delegation

DELETE /v1/delegations/:id

Revocation is immediate. After revocation, the grantee's API keys lose access to the delegated wallet instantly.

await wg.delegations.delete('del_01J...')

Delegations vs API Keys

API Endpoints

Permissions