put_api_management_v1_workspaces_slug_state

PUT

/api/management/v1/workspaces/{slug}/state

Authorizations

• bearer_auth

Request Body^required

Media typeapplication/json

object

ai_credentials

Array<object>

object

key

required

string

label

string | null

provider

required

string

budget

One of:

null

null

object

object

api_mode_controls

critical_threshold_percent

number | null format: double

hard_stop

boolean | null

monthly_cap_usd

number | null format: double

provider_monthly_caps_usd

threshold_alerts_percent

Array<number> | null

warning_threshold_percent

number | null format: double

capabilities

One of:

null

null

object

Optional MCP + skill capability map, mirroring the workspace manifest shape from ADR-0007. When present, the Management API applies it via the same apply_capabilities path used by POST /api/workspace/apply-manifest. Absent keys are no-ops — existing callers that don’t send this field keep working unchanged. See bw-infra docs/38 §4.6.

object

mcps

object

key

additional properties

One MCP or skill override inside a manifest. Mirrors the schema described in docs/schemas/supacloud-workspace.schema.json.

object

config

object

description

string | null

enabled

boolean

label

string | null

skills

object

key

additional properties

One MCP or skill override inside a manifest. Mirrors the schema described in docs/schemas/supacloud-workspace.schema.json.

object

config

object

description

string | null

enabled

boolean

label

string | null

git_credentials

Array<object>

object

auth_type

required

string

credential_data

required

string

git_provider

string | null

label

required

string

invites

Array<object>

object

email

required

string

role

required

string

mailbox_credentials

Array<object>

object

allowed_login_providers

Array<string>

email

required

string

imap_host

required

string

imap_port

integer format: int32

label

required

string

password_secret_ref

required

string

provider

string | null

use_tls

boolean

username

required

string

members

Array<object>

object

admin

boolean

approved

boolean

display_name

string | null

email

required

string

role

required

string

oauth_credentials

Array<object>

object

access_token

required

string

account_email

string | null

expires_at

string | null format: date-time

id_token

string | null

provider

required

string

refresh_token

required

string

projects

Array<object>

object

auto_developer_agent_type

string | null

auto_developer_enabled

#708 X2b — the PR-flow arming fields the management apply honors. auto_developer_enabled arms the pr_review automation arm; auto_developer_agent_type stamps its source_filter.harness. The legacy auto_developer_prompt/_modes/_draft_first/… spec fields were removed with the dropped projects.auto_developer_* columns.

boolean | null

auto_issue_debate_enabled

#708 M1/X5 — DEPRECATED. The standalone issue-debate lane was retired (#708 B3/X5): the council capability is the per-stage council flag, and the auto_issue_debate_* columns were dropped (migration 302). This field is KEPT only so a stale IaC manifest that tries to ARM the lane fails LOUDLY: an apply that sets it true is REJECTED with a 422 (see apply_project) sourced from THIS request field. false / absent stays accepted for backward-compatible manifests. The other auto_issue_debate_* spec fields were removed.

boolean | null

closeout_config

One of:

null

null

object

#708 M1 (K-06) — the project-tier tiered standard-closeout override (mig 283), reaching parity with the browser project PUT so an IaC apply can set it. A sparse JSONB bag documented by the CloseoutConfigPatch schema; on apply it is shape-validated (models::closeout::validate_patch) then merged into the applied project config exactly like the browser PUT (persisted via queries::projects::set_closeout_config). null / absent leaves the column untouched (the project inherits the workspace default). The management owner token acts as the workspace owner, so no additional per-field gate applies.

object

memory

Gates the Tier-0 closeout MEMORY proposal. None inherits the next tier.

boolean | null

project_docs

One of:

null

null

object

A sparse project-docs step override.

object

condition

string | null

enabled

boolean | null

globs

Array<string> | null

user_docs

One of:

null

null

object

A sparse user-docs step override.

object

condition

string | null

enabled

boolean | null

globs

Array<string> | null

langs

Array<string> | null

wiki

One of:

null

null

object

A sparse wiki step override.

object

condition

string | null

enabled

boolean | null

git_credential_label

string | null

git_default_branch

string | null

git_provider

string | null

git_repo_url

string | null

key

required

string

name

required

string

schedules

Array<object>

object

agent_type

required

string

cadence

required

string

config

key

required

string

next_run_at

required

string format: date-time

project_key

string | null

prompt

required

string

timezone

string | null

title

required

string

task_scopes

One of:

null

null

object

Optional task-scope configuration (5-stage MCP allowlist precedence per ADR-0007). Absent → no scope write. Empty TaskScopeConfig::default() → wipes all scoping back to “all enabled MCPs available to every task”.

object

by_agent_type

object

key

additional properties

Array<string>

by_project

object

key

additional properties

Array<string>

default_mcp_allowlist

Array<string> | null

tasks

Array<object>

object

agent_type

required

string

closeout

One of:

null

null

object

#708 S1 (K-05) — an optional TYPED per-run standard-closeout override, merged into config.closeout (the exact key the launch path’s resolve_closeout_for_task reads) by [Self::effective_config], so a M2M-launched task can set its closeout the same way the web run-start override does. A sparse JSONB bag documented by the CloseoutConfigPatch schema; null / absent inherits the project/workspace default.

object

memory

Gates the Tier-0 closeout MEMORY proposal. None inherits the next tier.

boolean | null

project_docs

One of:

null

null

object

A sparse project-docs step override.

object

condition

string | null

enabled

boolean | null

globs

Array<string> | null

user_docs

One of:

null

null

object

A sparse user-docs step override.

object

condition

string | null

enabled

boolean | null

globs

Array<string> | null

langs

Array<string> | null

wiki

One of:

null

null

object

A sparse wiki step override.

object

condition

string | null

enabled

boolean | null

config

object

key

additional properties

issue_id

Optional issue-link intent. When BOTH issue_id and issue_url are present, the launch path links the task to that existing issue by merging link_issue_id/link_issue_url into config via the typed services::tasks::IssueLinkConfig builder (ADR 0032, Issue #248). Either field alone is a no-op, keeping legacy callers that only send config unchanged.

string | null

issue_url

string | null

key

required

string

project_key

string | null

prompt

required

string

title

required

string

variables

Array<object>

object

is_secret

boolean

key

required

string

project_key

string | null

value

required

string

workspace

required

object

name

required

string

owner_email

string | null

Example^generated

{
  "ai_credentials": [
    {
      "key": "example",
      "label": "example",
      "provider": "example"
    }
  ],
  "budget": {
    "api_mode_controls": "example",
    "critical_threshold_percent": 1,
    "hard_stop": true,
    "monthly_cap_usd": 1,
    "provider_monthly_caps_usd": "example",
    "threshold_alerts_percent": [
      1
    ],
    "warning_threshold_percent": 1
  },
  "capabilities": {
    "mcps": {
      "additionalProperty": {
        "config": {},
        "description": "example",
        "enabled": true,
        "label": "example"
      }
    },
    "skills": {
      "additionalProperty": {
        "config": {},
        "description": "example",
        "enabled": true,
        "label": "example"
      }
    }
  },
  "git_credentials": [
    {
      "auth_type": "example",
      "credential_data": "example",
      "git_provider": "example",
      "label": "example"
    }
  ],
  "invites": [
    {
      "email": "example",
      "role": "example"
    }
  ],
  "mailbox_credentials": [
    {
      "allowed_login_providers": [
        "example"
      ],
      "email": "example",
      "imap_host": "example",
      "imap_port": 1,
      "label": "example",
      "password_secret_ref": "example",
      "provider": "example",
      "use_tls": true,
      "username": "example"
    }
  ],
  "members": [
    {
      "admin": true,
      "approved": true,
      "display_name": "example",
      "email": "example",
      "role": "example"
    }
  ],
  "oauth_credentials": [
    {
      "access_token": "example",
      "account_email": "example",
      "expires_at": "2026-04-15T12:00:00Z",
      "id_token": "example",
      "provider": "example",
      "refresh_token": "example"
    }
  ],
  "projects": [
    {
      "auto_developer_agent_type": "example",
      "auto_developer_enabled": true,
      "auto_issue_debate_enabled": true,
      "closeout_config": {
        "memory": true,
        "project_docs": {
          "condition": "example",
          "enabled": true,
          "globs": [
            "example"
          ]
        },
        "user_docs": {
          "condition": "example",
          "enabled": true,
          "globs": [
            "example"
          ],
          "langs": [
            "example"
          ]
        },
        "wiki": {
          "condition": "example",
          "enabled": true
        }
      },
      "git_credential_label": "example",
      "git_default_branch": "example",
      "git_provider": "example",
      "git_repo_url": "example",
      "key": "example",
      "name": "example"
    }
  ],
  "schedules": [
    {
      "agent_type": "example",
      "cadence": "example",
      "config": "example",
      "key": "example",
      "next_run_at": "2026-04-15T12:00:00Z",
      "project_key": "example",
      "prompt": "example",
      "timezone": "example",
      "title": "example"
    }
  ],
  "task_scopes": {
    "by_agent_type": {
      "additionalProperty": [
        "example"
      ]
    },
    "by_project": {
      "additionalProperty": [
        "example"
      ]
    },
    "default_mcp_allowlist": [
      "example"
    ]
  },
  "tasks": [
    {
      "agent_type": "example",
      "closeout": {
        "memory": true,
        "project_docs": {
          "condition": "example",
          "enabled": true,
          "globs": [
            "example"
          ]
        },
        "user_docs": {
          "condition": "example",
          "enabled": true,
          "globs": [
            "example"
          ],
          "langs": [
            "example"
          ]
        },
        "wiki": {
          "condition": "example",
          "enabled": true
        }
      },
      "config": {
        "additionalProperty": "example"
      },
      "issue_id": "example",
      "issue_url": "example",
      "key": "example",
      "project_key": "example",
      "prompt": "example",
      "title": "example"
    }
  ],
  "variables": [
    {
      "is_secret": true,
      "key": "example",
      "project_key": "example",
      "value": "example"
    }
  ],
  "workspace": {
    "name": "example",
    "owner_email": "example"
  }
}

Responses

200

Workspace desired state applied

Media typeapplication/json

object

changed

required

boolean

results

required

Array<object>

object

changed

required

boolean

fingerprint

string | null

id

string | null format: uuid

key

required

string

resource_type

required

string

workspace_id

required

string format: uuid

Example^generated

{
  "changed": true,
  "results": [
    {
      "changed": true,
      "fingerprint": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "key": "example",
      "resource_type": "example"
    }
  ],
  "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}