Read, create, revise, preview, version or publish a managed client site

Accepts only canonical Site Builder action names and their bounded params. Requires sites:read for reads, sites:write for revisions/session/context/template actions, or sites:publish for approval/access/execute actions, plus current client workspace capabilities. User-scoped keys only; creator-scoped keys are rejected. Requires an existing authorized managed client workspace binding; does not provision universal creator hosting. Writes require Idempotency-Key. Publish executes the existing exact approval/version contract; timeout returns pending, never success. MCP tools: bamf.list_sites, bamf.get_site, bamf.manage_site, bamf.publish_site.

post/workspaces/{workspace_id}/sites/action

Request

  • Base URL: https://api.bamf.ai/v1
  • URL: https://api.bamf.ai/v1/workspaces/{workspace_id}/sites/action
  • Auth: HTTP bearer

Path parameters

workspace_idstring uuid required

Headers

Idempotency-Keystring

Required for mutations; preserve this value on retry.

Request body

actionstring required

Canonical Site Builder action; discover supported read/write/publish enums from MCP tools/list.

paramsobject required

Canonical action parameters; server validates size, identities and approval contract.

Response

Normalized site result and request audit IDs

Changes

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