Legacy app-id transfer route

Resolve recipient + amount from context, then spend USDC from the app’s smart wallet via the user’s SpendPermission.

Mirrors the body of POST /mcp/transfer; the only differences are the auth model (new api_keys instead of mcp_api_keys) and the spender wallet (shared app.smart_wallet_address instead of per-key).

Deprecated for HEVN CLI usage: current CLI calls POST /apps/transfer and the backend resolves the app from the API key.

POST /api/v1/apps/{app_id}/transfer

Legacy app-id transfer route

cURL

curl --request POST \
  --url https://api.hevn.finance/api/v1/apps/{app_id}/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "quoteId": "<string>",
  "invoiceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "amount": 123,
  "memo": "<string>"
}
'

200

{
  "txHash": "<string>"
}

Authorizations

Authorization · string · header · default: Bearer <token> · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key · string | null

x-api-key · string · required

Path Parameters

app_id · string<uuid> · required

Body

application/json

Body of POST /apps/transfer.

Exactly one of contactId / quoteId / invoiceId MUST be set (mirrors the /mcp/transfer body). amount is required when contactId is the dispatch path; otherwise it's derived from the referenced invoice / quote.

contactId · string<uuid> | null

quoteId · string | null

invoiceId · string<uuid> | null

amount · number | null

memo · string | null

Response

200

application/json

Successful Response

txHash · string · required