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	3rd 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, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour