projects

Set a project's policy — the default (public) role for roleless requests (owner/admin; org approved)

put/v1/projects/{project_id}/policy

Request

  • Base URL: https://api.wavehouse.cloud
  • URL: https://api.wavehouse.cloud/v1/projects/{project_id}/policy
  • Auth: one of:
    • API key in cookie whc_session
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

project_idstring required

Request body

default_rolestring required

role granted to a roleless request (no token, or a token with no role claim) — the 'public' access level. Empty = roleless requests get no role (locked).

Response

OK

created_atstring date-time required
default_rolestring required

policy role for roleless requests (the 'public' access level); empty = locked

deletion_grace_secondsinteger required

how long a deletion scheduled now keeps the project's data before destroying it; cancellable until then

destroy_afterstring date-time

instant a scheduled deletion becomes due; present only while status is deleting or destroying

namestring required
org_idstring required

the org that owns the project

policy_deliveredboolean required

true = the running engine is enforcing this default_role NOW. false = it is saved as the seed the engine will boot with, but the project has no running engine to deliver to yet (see policy_delivery_detail).

policy_delivery_detailstring

why the value is not live yet; empty when policy_delivered is true

project_idstring required
provisioning_failedboolean

setting this project up did not finish and nothing is retrying it; POST .../provision resumes it from where it stopped

statusstring required

pending | provisioning | active | suspended | deleting (scheduled, cancellable until destroy_after) | destroying (the teardown has begun and can no longer be cancelled)

writes_pausedboolean

writes are paused for maintenance and resume on their own; reads, the id, credentials and policy are unaffected

Changes

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