Skip to content
by Unity Nodes
Partner docsapi reference › credits › post v1organizations credittransfer

NEAR AI Cloud: Post v1organizations credittransfer

Updated 13-11-2026

POST /v1/organizations/{org_id}/credit/transfer Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Parameters:

  • org_id (path, string, required): Sender organization.
  • Idempotency-Key (header, string): Generate a UUID once in the client before sending and reuse it on retries; required for amount sends, prohibited for cumulative targets; 1–100 characters.

Request body (application/json):

  • amount (integer, int64): Positive nano-USD amount; mutually exclusive with recipient_cumulative.
  • memo (string)
  • metadata (object)
  • payout_program (string): Required for cumulative targets; optional for amount sends.
  • recipient_cumulative (integer, int64): Nonnegative target for this sender, recipient, and payout program.
  • recipient_organization_id (string, uuid, required)
  • source_credit_type (string, required): payment, staking_farm, or grant (grant requires explicit policy opt-in).

Responses: 200: Original committed response replay or cumulative target already reached 201: Delivered; includes sender accounting only 409: idempotency_conflict, insufficient_posted_capacity or sender_not_reconciled