Egress policy

Replace a project’s egress policy (creates a new immutable version)

mode allow_all | allowlist | deny_all; rules/cidrs only with allowlist. Hosts: exact FQDN or *. single-label wildcard (IDNA-normalized, lower-case); IP literals and localhost-like names are rejected. Ports 1-65535 (default [443]); protocols tcp only. cidrs: public ranges only. Optional If-Match: <version> (409 conflict with details.reason version_mismatch). Owner/admin or an API key of this project with tool permissions.

put/v1/projects/{project_id}/egress-policy

Request

  • Base URL: https://api.shardflux.dev
  • URL: https://api.shardflux.dev/v1/projects/{project_id}/egress-policy
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

UUIDv7, lowercase canonical form.

Headers

if-matchstring

Request body

mode'allow_all' | 'allowlist' | 'deny_all' required
cidrsstring[]

allowlist only; public ranges; at most 64.

Response

Default Response

organization_idstring uuid required

UUIDv7, lowercase canonical form.

project_idstring uuid required

UUIDv7, lowercase canonical form.

versioninteger required

Current version number of the project policy (0 = none); send as If-Match.

Changes

No recorded changes to this operation across all 1 revision of this API.