Auth

Token exchange

Exchange API key for a JWT

post

Accepts an API key (user:{userId}:{secret}) and returns a short-lived JWT for use as a Bearer token on subsequent API requests.

Body

apiTokenstring · min: 1Required

API key: user::

Example: user:00000000-0000-0000-0000-000000000000:your-api-secret-here-36-chars-long

Responses

200

JWT issued successfully

application/json

accessTokenstringRequired

Bearer JWT

Example: eyJhbGciOiJIUzI1NiJ9...

userIdstringRequired

Authenticated user ID

Example: 2f310b4a-d3b3-47ca-b73e-e042df5e9e41

expiresInstringRequired

Token expiry duration

Example: 1h

400

Invalid token format

application/json

401

Token not found, disabled, or expired

application/json

post/auth

POST /auth HTTP/1.1
Host: api.eventx.io
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "apiToken": "user:00000000-0000-0000-0000-000000000000:your-api-secret-here-36-chars-long"
}

{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9...",
  "userId": "2f310b4a-d3b3-47ca-b73e-e042df5e9e41",
  "expiresIn": "1h"
}