Update an endpoint
PATCH
/v1/endpoints/{id}
Update editable fields. A url MOVES the route wholesale — domain, slug and path together — and re-checks per-RESOLVED-path uniqueness, so a clash returns 409, scoped per-org on a platform domain or per-domain on a custom domain (as createEndpoint). Because the URL is the WHOLE route rather than a partial edit, a URL with no path CLEARS the path.
Authorizations
apiKey
Scoped API key. Scopes are read ⊂ write ⊂ admin. A call needing more scope than the key holds returns 403 insufficient_scope.
Type
HTTP (bearer)
Parameters
Path Parameters
id*
Type
Requiredstring
Request Body
application/json
JSON "url": "https://wh.emhk.in/acme/shopify-store/orders", "name": "Shopify orders", "preset": "shopify", "status": "paused", "destinations": [ "string" ], "responseRules": { "rules": [ { "when": { "type": "string", "name": "string", "path": "string", "op": "string", "value": "string", "all": [ { } ], "any": [ { } ], "not": "[Circular Reference]" }, "respond": { "status": 201, "body": "{"pong":true}", "headers": { "additionalProperties": "string" } } } ], "default": { "status": 201, "body": "{"pong":true}", "headers": { "additionalProperties": "string" } } }, "responseProxy": { "target": "managed", "code": "string", "url": "string", "timeoutMs": 0, "onUnavailable": "string" }, "transform": { "engine": "managed", "code": "string", "url": "string", "failMode": "string", "timeoutMs": 0 }, "response": { "type": "meta-challenge", "verifyToken": "string", "secret": "string", "verificationToken": "string", "endpointUrl": "string", "status": 0, "body": "string", "headers": { "additionalProperties": "string" } }
{
}
Responses
The updated endpoint.
application/json
JSON "id": "ep_01JX9", "slug": "shopify-store", "path": "/orders", "name": "Shopify orders", "preset": "shopify", "url": "https://wh.emhk.in/acme/shopify-store/orders", "domain": { "id": "pdom_wh_emhk_in", "host": "wh.emhk.in", "kind": "platform" }, "destinations": [ "string" ], "responseRules": { "rules": [ { "when": { "type": "string", "name": "string", "path": "string", "op": "string", "value": "string", "all": [ { } ], "any": [ { } ], "not": "[Circular Reference]" }, "respond": { "status": 201, "body": "{"pong":true}", "headers": { "additionalProperties": "string" } } } ], "default": { "status": 201, "body": "{"pong":true}", "headers": { "additionalProperties": "string" } } }, "responseProxy": { "target": "managed", "code": "string", "url": "string", "timeoutMs": 0, "onUnavailable": "string" }, "transform": { "engine": "managed", "code": "string", "url": "string", "failMode": "string", "timeoutMs": 0 }, "response": { "type": "meta-challenge", "verifyToken": "string", "secret": "string", "verificationToken": "string", "endpointUrl": "string", "status": 0, "body": "string", "headers": { "additionalProperties": "string" } }, "verification": "hmac-sha256", "status": "active"
{
}