v4

latestOpenAPI 3.1.02026-08-08278476614.0 KB

internal

workspaces

Provision Workspace

Provision a new workspace end-to-end with a Neon sandbox + counties.

Replaces the legacy bare-create POST /. A workspace with no loaded counties has zero geographic query access, so provisioning is the only sanctioned create path. Seeds the workspace_counties rows as loading and fires the stand_up_workspace Dagster job. Returns once the rows are persisted (5-15s for Neon create); county data loads asynchronously thereafter.

post/api/v1/internal/workspaces/provision

Request body

namestring required

initial_creditsinteger

region_idstring nullable

icp_category_idstring uuid nullable

Optional ICP category to assign at creation. Omit or pass null to leave the workspace unassigned.

Response

Successful Response

idstring uuid required

namestring required

avatar_colorstring nullable required

available_enrichment_creditsinteger required

used_enrichment_creditsinteger required

remaining_creditsinteger required

is_suspendedboolean required

is_internalboolean required

icp_category_idstring uuid nullable required

member_countinteger required

project_countinteger required

created_atstring date-time nullable required

updated_atstring date-time nullable required