Gwop APIAuth

Create auth intent

View as Markdown

Create an authentication challenge for an AI agent.

The response includes payment methods for every chain the merchant has configured. The returned challenge amount is the source of truth for the auth challenge amount; do not hard-code a protocol constant.

Authentication

AuthorizationBearer
Merchant API key (`sk_m_*`). ``` Authorization: Bearer sk_m_abc123def456... ```

Headers

Idempotency-KeystringOptionalformat: "uuid"

Client-generated UUID v4 for safe retries. Requests with the same key return the original response.

Request

This endpoint expects an object.
known_wallet_hintstringOptionalformat: "^(base:0x[a-fA-F0-9]{40}|solana:[1-9A-HJ-NP-Za-km-z]{32,44})$"

Previous wallet identity for continuity. Format {chain}:{wallet}.

metadatamap from strings to anyOptional

Response headers

X-Request-Idstring
Unique request identifier for debugging and support

Response

Auth intent created
auth_intent_idstringformat: "^ai_.+$"
statusenum
Allowed values:
expires_atdatetime
challengeobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error