projects

Set a project's tunable engine settings — dedupe, CORS origins, query shaping (owner/admin; org approved)

put/v1/projects/{project_id}/settings

Request

  • Base URL: https://api.wavehouse.cloud
  • URL: https://api.wavehouse.cloud/v1/projects/{project_id}/settings
  • 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

cors_allowed_originsstring[]

browser origins the data-plane allows. Empty = block all browser origins (server-side ingest/queries are unaffected by CORS); "*" = allow any origin. Otherwise each entry must be an exact scheme://host[:port] — no path, no wildcard: the engine matches origins literally, and an entry it cannot match this way is rejected with a 422 naming it. Only affects browser clients. The WaveHouse Cloud console is always allowed automatically and need not be listed

dedupe_enabledboolean

drop duplicate rows by a stable id field (idempotent ingest)

dedupe_id_fieldstring

JSON field the dedupe key reads (engine default: event_id)

dedupe_require_idboolean

reject rows missing the dedupe id field (strict idempotency)

query_default_max_rowsinteger

fallback result LIMIT when a query specifies none; 0 = engine default (10000)

query_timeout_secondsinteger

max seconds a read may run; 0 = engine default (30)

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

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.