Create a Domain Authentication
Create a token authentication for an ingest domain.
Request
Request-Line
POST /lls/v1.0/domain/{domain}/authentication
Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Mandatory | Ingest domain name. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| authentication | Boolean | Mandatory | Enable authentication or not. |
| authenticationType | String | Optional | Authentication type. Valid values: default, 3rdparty. |
| 3rdPartyEndpoint | String | Optional | Third party endpoint for authentication. |
Response
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Mandatory | Ingest domain name. |
| created | Timestamp | Mandatory | Timestamp of created time in UTC timezone. Default is now. |
| authentication | Boolean | Mandatory | Enable authentication or not. |
| authenticationType | String | Optional | Authentication type. Valid values: default, 3rdparty. |
| authenticationKey | String | Optional | Authentication key for default authentication. |
| 3rdPartyEndpoint | String | Optional | Third party endpoint for authentication. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | LLS.Domain.Invalid | Domain name invalid. |
Examples
Enable default authentication
Request
POST /lls/v1.0/domain/ingest.example.com/authentication HTTP/1.1
{
"authentication": true,
"authenticationType": "default"
}
Successful Response Body
{
"domain": "ingest.example.com",
"created": "2025-07-10T09:30:00Z",
"authentication": true,
"authenticationType": "default",
"authenticationKey": "abcdef123456"
}
Enable 3rd party authentication
Request
POST /lls/v1.0/domain/ingest-3rdparty.example.com/authentication HTTP/1.1
{
"domain": "ingest-3rdparty.example.com",
"authentication": true,
"authenticationType": "3rdparty",
"3rdPartyEndpoint": "https://auth.example.com/check"
}
Successful Response Body
{
"domain": "ingest-3rdparty.example.com",
"created": "2025-07-10T09:30:00Z",
"authentication": true,
"authenticationType": "3rdparty",
"3rdPartyEndpoint": "https://auth.example.com/check"
}
Disable token authentication
Request
POST /lls/v1.0/domain/ingest.example.com/authentication HTTP/1.1
{
"authentication": false
}
Successful Response Body
{
"domain": "ingest.example.com",
"created": "2025-07-10T09:30:00Z",
"authentication": false
}
Best Practices
Rate Limiting
Rate Limits
Rate limiting is posed upon the API, check API calls to comply with the rate limit below:
- 100 requests per minute
- 1000 requests per hour