Create a workspace
Start another brand or test target with the same account. Sign in with permission to create workspaces in your organization. To select an existing workspace, use directory linking.
1. Create the workspace
This example uses jq to read the returned ID. Replace the name with your target. Reuse the same idempotency key when retrying the same creation request.
CREATE_WORKSPACE_KEY=$(uuidgen)
orc workspaces create \
--name 'YOUR_WORKSPACE_NAME' \
--idempotency-key "$CREATE_WORKSPACE_KEY" \
--json > workspace.json
WORKSPACE_ID=$(jq -er '.data.id' workspace.json)This creates an empty workspace. You do not need another account, another invitation, or a manually created brand. The initial setup generates the brand and observation candidates.
2. Select and read back the returned ID
orc workspace use "$WORKSPACE_ID"
orc workspaces get "$WORKSPACE_ID" --workspace "$WORKSPACE_ID" --json
orc workspaces setup get --workspace "$WORKSPACE_ID" --jsonVerify that the same ID can be read and its setup state is available. Pass that ID to subsequent commands. workspace use changes your user default. Agents working on several targets concurrently should pass --workspace to every command.
3. Continue to the first observation
Follow Run the first observation and read its results to generate candidates from a website URL and confirm the reviewed configuration. Confirmation starts the first observation. Workspace creation alone does not complete it.
Account invitation access and workspace measurement allowances are checked separately. If setup stops with measurement_quota_exhausted, share the workspace ID and error with your contact. Do not work around it by registering again or creating another workspace.