Register primary authentication

POST

/api/v1/wallets/{entityId}/register-auth

Registers primary authentication for an entity. This must be called before any wallet operations.

Supported Auth Types:

API_Key: Permanent key-based authentication

OAuth: OIDC-based authentication

Email_Auth: Email OTP authentication

SMS_Auth: SMS OTP authentication

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Authentication registered successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

API Key AuthenticationEmail Authentication

curl --location --request POST '/api/v1/wallets//register-auth' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authType": "API_Key",
    "authPayload": {
        "apiKeyName": "my-api-key",
        "curveType": "API_KEY_CURVE_SECP256K1",
        "publicKey": "0x04a1b2c3d4e5f6...",
        "expirationSeconds": "31536000"
    }
}'

Response Example

200 - Example 1

{
    "success": true
}

Modified at 2025-11-22 18:19:15

Teleport Routes by Entity

Prepare wallet creation challenge (Step 1)