Skip to main content
​
X-API-Key
string
required
Your organization’s API key
​
email
string
required
Email address of the user to authenticate. If the user doesn’t exist, they will be created automatically.

​
Response

​
token
string
required
JWT token to use for subsequent API requests. Valid for 6 hours.
​
member_id
string
required
Unique identifier of the authenticated user.
​
organization_id
string
required
Unique identifier of the organization the user belongs to.
​
expires_at
string
required
ISO 8601 timestamp when the token expires.
curl -X POST https://api.trellis.sh/v1/authenticate \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1NTBlODQwMC1lMjliLTQxZDQtYTcxNi00NDY2NTU0NDAwMDAiLCJvcmciOiJvcmdfYWJjMTIzIiwiaWF0IjoxNzA0OTY3MjAwLCJleHAiOjE3MDQ5ODg4MDB9.signature",
  "member_id": "550e8400-e29b-41d4-a716-446655440000",
  "organization_id": "org_abc123",
  "expires_at": "2025-01-11T18:00:00+00:00"
}