Authentication

User authentication and management

Sync authentication token

post

Syncs a Privy access token with the MeshMap auth service to obtain a session token.

Header parameters

AuthorizationstringRequired

Bearer token (Privy access token)

Responses

200

Token synced successfully

application/json

objectOptional

Session token response from auth service

401

Missing or invalid token

application/json

500

Auth service not configured

application/json

503

Auth service unavailable

application/json

post/auth/sync

HTTPcURLJavaScriptPython

POST /api/auth/sync HTTP/1.1
Authorization: text
Accept: */*

{}

Get user by ID

get

Query parameters

userIdstringRequired

Responses

200

User found

application/json

idstringOptional

walletAddressstring · nullableOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

400

Bad request

application/json

404

Resource not found

application/json

500

Internal server error

application/json

get/auth/user

HTTPcURLJavaScriptPython

GET /api/auth/user?userId=text HTTP/1.1
Accept: */*

{
  "id": "text",
  "walletAddress": "text",
  "createdAt": "2026-07-17T01:28:12.589Z",
  "updatedAt": "2026-07-17T01:28:12.589Z"
}

Create or retrieve a user

post

Body

application/json

dynamicUserIdstringRequired

walletAddressstring · nullableOptional

Responses

200

Existing user returned

application/json

idstringOptional

walletAddressstring · nullableOptional

createdAtstring · date-timeOptional

updatedAtstring · date-timeOptional

isNewUserbooleanOptional

201

New user created

application/json

400

Bad request

application/json

500

Internal server error

application/json

post/auth/user

HTTPcURLJavaScriptPython

POST /api/auth/user HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "dynamicUserId": "text",
  "walletAddress": "text"
}

{
  "id": "text",
  "walletAddress": "text",
  "createdAt": "2026-07-17T01:28:12.589Z",
  "updatedAt": "2026-07-17T01:28:12.589Z",
  "isNewUser": true
}