session.transfers.create

create(body: CreateTransferRequest, options?: IdempotentRequestOptions): Promise<Transfer>


Endpoint	`POST /v1/units/{unit_id}/transfers`
Credential	Session token (`end_sess_...`)
Retry class	`keyed`
Idempotency key	Accepted

Carries an idempotency key. Retried on network failure, timeout, 429, and 409 idempotency.in_progress - never on a 5xx.

Example

const result = await session.transfers.create({
  to: "0x1111111111111111111111111111111111111111",
});

string

required

string

required

Address that will receive the unit.

201 - Transfer.

string

required

string

required

string

required

string

required

'prepared' | 'confirmed' | 'expired' | 'failed'

required

object | null

Payload the unit’s current owner submits to complete the transfer. Returned when the transfer is created.

string

required

Branch on error.code, never on the HTTP status - several codes share one.

Code	HTTP	Retry
`auth.forbidden`	403	Do not retry
`auth.unauthorized`	401	Do not retry
`collection.not_active`	409	Wait, then retry
`idempotency.in_progress`	409	Safe to retry
`idempotency.key_conflict`	409	Do not retry
`internal.error`	500	Safe to retry
`rate_limit.exceeded`	429	Safe to retry
`session_token.invalid_or_expired`	401	Do not retry
`session_token.wrong_chip`	403	Do not retry
`transfer.already_to_recipient`	409	Do not retry
`transfer.in_progress`	409	Poll the resource
`transfer.owner_unknown`	409	Wait, then retry
`unit.not_found`	404	Do not retry
`unit.not_minted`	409	Poll the resource
`validation.failed`	400	Do not retry

See Errors and retries for the error types and how to narrow them.