Modify a Domain
Modify the domain. Currently only status can be modified
Request
Request-Line
PUT /lls/v1.0/domain/{domain}
Request Parameters
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Mandatory | Domain name. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| status | String | Mandatory | Domain status. Valid values: active, inactive. |
Response
Response Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| domain | String | Mandatory | Domain name |
| type | String | Mandatory | Domain type. Valid values: ingest, delivery. |
| created | Timestamp | Mandatory | Timestamp of created time in UTC timezone. |
| updated | Timestamp | Mandatory | Timestamp of updated time in UTC timezone. Default is now. |
| status | String | Mandatory | Status of domain. Valid values: active, inactive. |
| associatedDeliveryDomain | Array | Optional | Associated delivery domain name. It is available for ingest domain only. |
| authentication | Boolean | Optional | Enable authentication or not. It is available for ingest domain only. |
| authenticationType | String | Optional | Authentication type. Valid values: default, 3rdparty. It is available for ingest domain only. |
| authenticationKey | String | Optional | Authentication key. It is available for authenticationType=default only. |
| 3rdPartyEndpoint | String | Optional | Third party endpoint for 3rdparty authentication. It is available for authenticationType=3rdparty only. |
Status Codes, Error Codes and Error Messages
| Status Code | Error Code | Error Message |
|---|---|---|
| 400 | LLS.Domain.NotFound | Domain name is not found. |
Examples
Modify a domain name
Request
PUT /lls/v1.0/domain/ingest.example.com HTTP/1.1
{
"status": "inactive"
}
Successful Response Body
{
"domain": "ingest.example.com",
"type": "ingest",
"created": "2025-07-10T09:10:00Z",
"updated": "2025-07-10T09:35:00Z",
"status": "inactive",
"CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
"authentication": true,
"authenticationType": "default",
"authenticationKey": "abcdef123456"
}
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