SynapseDocumentation

Verify signature, return JWT

Submit the EIP-191 signed challenge. Gateway verifies the signature and returns a 24-hour JWT.

POST/api/v1/auth/verifyNo auth

For AI agents

Step 2 of owner auth. Submit the signed challenge. On success the gateway returns a 24-hour JWT. Store it — all owner-side calls require it as the Bearer token.

Requires: GET /auth/challenge must be called first

Next: Store the JWT. Call GET /balance, POST /agent/credentials, or GET /services

Generated OpenAPI reference

POST/api/v1/auth/verify

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?any

Response Body

application/json

application/json

application/json

curl -X POST "https://api-staging.synapse-network.ai/api/v1/auth/verify" \  -H "Content-Type: application/json" \  -d '{    "address": "0xYourWalletAddress",    "message": "Synapse login nonce: abc123 | ts: 1711234567",    "signature": "0x..."  }'
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
{
  "code": "VERIFICATION_FAILED",
  "message": "Signature does not match wallet address"
}
{
  "code": "CHALLENGE_EXPIRED",
  "message": "Challenge expired — request a new one"
}
Back to API Reference