Guest Registration

Register guest device

Register a guest device and return an API key.

If the device_id is already registered, the endpoint returns a conflict instead of rotating the existing guest API key.

post/v1/guest

Request

  • Base URL: https://api.knowhereto.ai/api
  • URL: https://api.knowhereto.ai/api/v1/guest
  • Auth: none declared

Request body

device_idstring required

Stable client device identifier

clientstring required

Client application name, e.g. knowhere-hub

platformstring required

Operating system, e.g. macos

app_versionstring nullable

Client application version

Response

Successful Response

guest_user_idstring required
device_idstring required
api_keystring required

Plaintext API key (sk_...), issued on first registration

expires_atstring date-time nullable required

API key expiry timestamp, or null for non-expiring guest keys

Changes

No recorded changes to this operation across all 1 revision of this API.