Overview

The Client Management REST APIs provide comprehensive functionality for managing identity clients, including client identification and alias management.

What This API Does

• Client Query: Query and retrieve detailed information about connected clients
• Client Aliases: Create, update, delete, and query custom aliases for client devices

Error Handling

The API uses standard HTTP status codes with detailed error messages in the response body.

Common Error Responses

All endpoints may return these common error responses:

• 400 Bad Request: Invalid input data or validation errors
• 401 Unauthorized: Missing or invalid authentication token
• 403 Forbidden: Insufficient permissions for the requested operation
• 404 Not Found: Requested client or resource doesn't exist
• 409 Conflict: Resource conflict (e.g., duplicate alias)
• 422 Unprocessable Entity: Business rule violations
• 500 Internal Server Error: Unexpected server errors