GET /v1/me
Return the user and tenant the current Bearer token belongs to. Use it as a smoke test for authentication.
Returns the user and tenant the Bearer token belongs to. The cheapest way to confirm a token is valid before issuing a real action.
GET /api/v1/me
Request
No body or query parameters. Just the auth header.
curl https://www.qyvo.io/api/v1/me \
-H "Authorization: Bearer YOUR_TOKEN_HERE"
const me = await fetch('https://www.qyvo.io/api/v1/me', {
headers: { Authorization: `Bearer ${process.env.QYVO_TOKEN}` },
}).then((r) => r.json());
$me = Http::withToken(env('QYVO_TOKEN'))
->get('https://www.qyvo.io/api/v1/me')
->json();
import os, httpx
me = httpx.get(
'https://www.qyvo.io/api/v1/me',
headers={'Authorization': f"Bearer {os.environ['QYVO_TOKEN']}"},
).json()
Response — 200 OK
{
"id": 42,
"email": "[email protected]",
"name": "Romain",
"tenant": {
"id": "01HZX9...",
"name": "Acme Co."
}
}
| Field | Type | Notes |
|---|---|---|
id |
integer | Internal user id |
email |
string | User's login email |
name |
string | null | Display name |
tenant.id |
UUID | Workspace id — the scope every other endpoint operates on |
tenant.name |
string | Workspace display name |
tenant |
object | null | null if the user has no tenant — every other endpoint will return 422 No workspace configured |
Errors
| Status | Body | Cause |
|---|---|---|
401 |
{"message": "Unauthenticated."} |
Token missing, wrong, or revoked |