HTTP API reference
Presence
Online status of users in an environment and tenant. Generated from the OpenAPI specification.
Online status of users in an environment and tenant.
GET /v1/presence/{userId}
Presence of a user in the caller's project environment and tenant.
Authentication: Messaging token (Authorization: Bearer <token>), from the user’s device.
Path parameters
| Field | Type | Required | Notes |
|---|---|---|---|
userId | string | Yes | pattern ^[A-Za-z0-9._@-]{1,128}$ |
Response 200 OK
| Field | Type | Required | Notes |
|---|---|---|---|
userId | string | Yes | |
status | "online", "offline", "away", "dnd", "busy" | Yes | |
lastSeenAt | string or null | Yes | nullable |
Errors: 400 Invalid request · 401 Missing or invalid credentials · 403 Not permitted · 404 Not found (including resources of other projects) · 429 Rate limit or quota exceeded. Error bodies follow the error format.