Skip to content

Update an origin server

PATCH
/api/organizations/{organizationId}/origin-servers/{id}

Partially update an origin server. Only provided fields will be updated. Set requestHostname to null to clear it. Uniqueness of the name and of the address+port pair within the organization is re-validated, and a changed address is re-checked against the internal-range deny-list.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext).

Type
API Key (header: X-API-TOKEN)
or
JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type
HTTP (bearer)

Parameters

Path Parameters

organizationId*

Organization identifier

Type
string
Required
id*

origin-server identifier

Type
string
Required

Request Body

application/merge-patch+json
JSON
{
  
"name": "primary-eu-west",
  
"protocol": "https",
  
"address": "origin.example.com",
  
"port": 443,
  
"requestHostname": "internal-app.example.com"
}

Responses

origin-server resource updated

JSON
{
  
"@context": "string",
  
"@id": "string",
  
"@type": "string",
  
"id": "0f8fad5b-d9cb-469f-a165-70867728950e",
  
"name": "primary-eu-west",
  
"protocol": "https",
  
"address": "origin.example.com",
  
"port": 443,
  
"requestHostname": "internal-app.example.com",
  
"createdAt": "2026-01-15T09:30:00+00:00",
  
"updatedAt": "2026-01-15T09:30:00+00:00"
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI