Users

The authenticated user and their registered devices.

Guides:Authentication

The user object

Identity of the user that owns the calling API key or session.

Attributes

idstringrequired
Identifier of the authenticated Vetnio user (a UUID). It is the same ID that appears as userId, creatorId or Vet ID in other responses.

The user object

{
  "id": "c1b0f2a0-f819-5fcc-a2ed-85db0cef66a7"
}

Get the authenticated user

GET/user/me

Returns the ID of the user behind this request: the owner of the personal or mobile-device API key, or the signed-in user for a browser session. Clients use it to correlate their own telemetry with the user's activity. Organization (sk_org_…) and workspace (sk_ws_…) keys are not accepted and get 403.

AcceptsPersonal key

Returns

idstringrequired
Identifier of the authenticated Vetnio user (a UUID). It is the same ID that appears as userId, creatorId or Vet ID in other responses.

Errors

400: The request is malformed or failed validation.
401: The API key is missing, invalid or revoked.
403: The key is valid but may not perform this action on this resource.
404: The resource does not exist or is not visible to this key.
500: Something went wrong on Vetnio's side.

Request

curl "https://vetnio.com/api/v2/user/me" \
  -H "Authorization: Bearer $VETNIO_API_KEY"

Response

{
  "id": "c1b0f2a0-f819-5fcc-a2ed-85db0cef66a7"
}

Register the calling device

POST/user/register-mobile-device

Labels the device that owns the API key used to make this request, so it appears under the user's connected devices in the web app and can be revoked individually. The mobile app calls it right after pairing with the key obtained from the QR-code flow. Must be called with an API key in the Authorization header (a session gets 400). The key is marked as a mobile-device key, which removes it from the user's programmatic API-key list, so do not call this with a key used for server integrations. Safe to repeat.

AcceptsPersonal key

Request body

deviceNamestringoptional
Name the device reports for itself, 1-60 characters after trimming. Applied only while the key still has the default name New device; a name the user typed in the web app when pairing always wins. Omit to keep the current name.
at least 1 characters · at most 60 characters
platformstringoptional
Free-text platform label shown next to the device, up to 40 characters, for example ios or android. Omitting it or sending an empty string clears the stored platform.
at most 40 characters

Returns

successbooleanrequired
Always true when the device details were saved.

Errors

400: The request is malformed or failed validation.
401: The API key is missing, invalid or revoked.
403: The key is valid but may not perform this action on this resource.
500: Something went wrong on Vetnio's side.

Request

curl -X POST "https://vetnio.com/api/v2/user/register-mobile-device" \
  -H "Authorization: Bearer $VETNIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "deviceName": "Reception iPad",
  "platform": "ios"
}'

Response

{
  "success": true
}