Skip to navigation
Workspace APINetwork Policies

Replace a network policy

View as Markdown

Mints a NEW policy id from this body. The named policy and every published version using it stay exactly as they were — save the new id on the agent draft and publish it for the change to take effect. Authorization: org admin.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

policyIdstringRequiredformat: "^net_[0-9A-HJKMNP-TV-Z]{26}$"

Request

This endpoint expects an object.
namestringRequired1-200 characters
hostsmap from strings to objectsRequired

Host → rule. A key is an exact lowercase public DNS hostname: no port, no wildcard, no path, no IP literal, no internal or private target. At most 50.

Response

The replacement policy, under a new id.
dataobject

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error