Create intent mandate

Create an intent mandate draft (a pre-authorized spending budget). If the agent is already authorized the mandate moves to pending_signature; otherwise the response includes an authorizationUrl for user onboarding.

POST

https://walletapi.fluxapay.xyz/api/mandates/create-intent

Authorizations

agentJwt

Agent registration JWT. Send as Authorization: Bearer <agent-jwt>.

Type

HTTP (bearer)

Request Body

application/json

Request body for creating an intent mandate draft.

The intent describing the mandate's purpose and spending constraints.

Responses

Mandate draft created. agentStatus indicates whether the agent is ready to sign or needs wallet authorization.

Content-Type

application/json

Response returned after creating an intent mandate draft.

Valid values"ok"

The created mandate identifier.

URL to surface to the user to sign the mandate, or to onboard/authorize the agent's wallet.

Format"uri"

When the mandate expires.

Format"date-time"

Whether the agent is ready to sign, or still needs wallet authorization.

Valid values"ready""needs_wallet_authorization"

{
  "status": "<string>",
  "mandateId": "<string>",
  "authorizationUrl": "<string>",
  "expiresAt": "<string>",
  "agentStatus": "<string>"
}