Skip to content

Device authentication

POST
/api/devices/v1/authentication/auth_requests

Device authentication endpoint.

Accepts two auth modes:

  1. X-API-Key header — validates the key and returns a text response, for backward compatibility with older agents.

  2. Token body — the client sends a JSON body with tenant_token set to the API key. The server validates the token and returns a signed JWT that the client uses as Authorization: Bearer <jwt> on subsequent requests.

The OTA-Pulse device agent uses mode 2.

Responses

200

Successful Response