Login
Authenticate with your credentials to obtain an access token.
POST
/api/v1/auth/loginDescription
The login endpoint authenticates a user with their client credentials (client_id and client_secret), returning a JSON Web Token valid for 4 hours. The token should be included in the Authorization header for all subsequent API requests.
Before You Begin
You'll need your API credentials to authenticate. To obtain them:
- Log in to your Unduit account.
- Go to Configure → API Credentials and generate a key.
- Set an expiration date and grant Read/Write permissions.
- Copy the Client ID and Client Secret.
If you don't see API Credentials in your Configure, contact your account administrator.
Request
Headers
| Header | Value | Required |
|---|---|---|
| Content-Type | application/json | Yes |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| client_id | string | Yes | Your client identifier from Configure → API Credentials |
| client_secret | string | Yes | Your client secret from Configure → API Credentials |
Response
Response Fields
| Field | Type | Description |
|---|---|---|
| message | string | Status message indicating successful login |
| token | string | JWT token valid for 4 hours |
Error Responses
Common error responses you may encounter when using this endpoint.
Notes
- Access tokens expire after 4 hours. Use the refresh token endpoint to obtain a new token without re-authenticating.
- Always include the Bearer Token in the Authorization header for secured endpoints.
- Store tokens securely on the client-side to prevent unauthorized access. Never expose them in version control.
Related Endpoints
Did this page help you?
Request Example
curl -X POST https://dev-api.unduit.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"client_id": "[email protected]",
"client_secret": "your-client-secret"
}'Success Response (200)
{
"message": "Login successful",
"token": "YOUR_ACCESS_TOKEN_HERE"
}Error Responses
401 Unauthorized
{
"message": "Invalid email or password"
}