Retire a scope's live policy document (it falls back to the next scope)

DELETE

/policies/{scope_kind}/{scope_ref}

const url = 'https://quikstik-core.fly.dev/policies/tenant/example';
const options = {
  method: 'DELETE',
  headers: {
    'x-tenant-id': '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0',
    Authorization: 'Bearer <token>'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://quikstik-core.fly.dev/policies/tenant/example \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'

Auth as putPolicy (a staff session, or an operator key scoped policies.write). History is kept; the scope’s bookings-to-be inherit from the next scope.

Authorizations

bearerAuth
operatorApiKey

Parameters

Path Parameters

scope_kind

required

string

Allowed values: tenant offering variant channel

scope_ref

required

string

Header Parameters

x-tenant-id

required

string format: uuid

Tenant identifier (UUID).

Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.

Responses

204

Retired.

404

policy_not_found — no live document at that scope.

422

invalid_scope_kind / invalid_scope_ref.

503

No durable backend is wired for this operation (fail-closed)

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}