> ## Documentation Index
> Fetch the complete documentation index at: https://chatobserver.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a client brand workspace

> Create a standard client brand workspace in the same organization as the connected x-workspace-id. Requires explicit workspaces:create consent and current organization owner/admin membership. Uses native provisioning, memberships and commercial entitlements. The connection receives access to the workspace it creates only. Does not create prompts, run providers or connect analytics. Preserve the retry key and request after uncertainty.

Required scopes: `workspaces:create`.


## OpenAPI

````yaml POST /api/v2/mcp/workspaces
openapi: 3.1.1
info:
  title: chatobserver public API
  version: '2026-09-09'
  description: >-
    Track AI visibility, manage prompts, inspect collected answers and
    citations, and integrate workspace data with your own tools. Visibility
    endpoints use workspace API keys. Data endpoints use scoped service-account
    keys; spreadsheet client endpoints use authorised client sessions. See the
    authentication guide for each credential type.
  contact:
    name: chatobserver support
    url: https://chatobserver.com/contact
    email: support@chatobserver.com
servers:
  - url: https://app.chatobserver.com
    description: Production API
security:
  - WorkspaceKey: []
  - BearerKey: []
tags:
  - name: Workspace
    description: Validate access and list the workspace project and available platforms.
  - name: Prompts
    description: Create, schedule, organise, activate and retrieve tracked prompts.
  - name: Answers
    description: Retrieve collected AI answers, their analysis and visibility trends.
  - name: Brands
    description: Manage brands and compare their visibility in AI answers.
  - name: Sources and citations
    description: Analyse cited domains, pages and ownership across answers.
  - name: Visitor analytics
    description: Read website visitor and crawler analytics for the workspace.
  - name: Content opportunities
    description: Retrieve content-gap findings and recommendations for tracked prompts.
  - name: Usage
    description: Read workspace consumption and allowance summaries.
  - name: Data connections
    description: Discover authorised connections, source accounts and connector catalogues.
  - name: Data queries
    description: >-
      Create versioned queries, publish definitions and inspect integration
      contracts.
  - name: Data operations
    description: >-
      Execute, validate, cancel and inspect operations and page through result
      rows.
  - name: Data delivery
    description: Manage schedules, transfers, destinations and import workflows.
  - name: Data definitions
    description: Manage reusable definitions and their immutable versions.
  - name: Data webhooks
    description: >-
      Configure event delivery, inspect deliveries, replay events and rotate
      secrets.
  - name: Client authorisation
    description: Authorise spreadsheet clients using a user-approved challenge exchange.
  - name: Spreadsheet clients
    description: >-
      Access document-bound client sessions, queries, schedules, bindings and
      write claims.
  - name: AI visibility audits
    description: Create website visibility audits and retrieve their report links.
  - name: Version 1
    description: Integrate with the version 1 visibility and analytics endpoints.
  - name: Tracked coverage
    description: >-
      Track published coverage, maintain its metadata and inspect exact-page
      citation evidence with the same workspace feature access as the dashboard.
  - name: Reports
    description: >-
      Discover accessible native reports and assess exact saved revisions using
      measured, context-specific evidence.
  - name: SEO
    description: >-
      Use authorized workspace SEO tools through the stateless MCP endpoint.
      Availability follows native workspace access and rollout controls; paid
      tools require a separately configured SEO allowance and spending
      admission. OpenSEO AI visibility tools remain unavailable.
paths:
  /api/v2/mcp/workspaces:
    post:
      tags:
        - MCP connections
      summary: Create a client brand workspace
      description: >-
        Create a standard client brand workspace in the same organization as the
        connected x-workspace-id. Requires explicit workspaces:create consent
        and current organization owner/admin membership. Uses native
        provisioning, memberships and commercial entitlements. The connection
        receives access to the workspace it creates only. Does not create
        prompts, run providers or connect analytics. Preserve the retry key and
        request after uncertainty.
      operationId: createMcpWorkspace
      parameters:
        - name: x-workspace-id
          in: header
          required: true
          schema:
            type: string
            pattern: ^ws_[a-f0-9]{32}$
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 16
            maxLength: 128
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/McpWorkspaceCreateRequestV1'
      responses:
        '201':
          description: >-
            Completed native operation; identical retries return the original
            result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpWorkspaceCreateResponseV1'
        default:
          description: Invalid input, missing consent or denied native access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - McpConnection: []
components:
  schemas:
    McpWorkspaceCreateRequestV1:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 100
        primaryDomain:
          type: string
          minLength: 1
          maxLength: 253
      required:
        - name
        - primaryDomain
      additionalProperties: false
    McpWorkspaceCreateResponseV1:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
              pattern: ^ws_[a-f0-9]{32}$
            name:
              type: string
            primaryDomain:
              type: string
            role:
              type: string
              enum:
                - owner
                - admin
          required:
            - id
            - name
            - primaryDomain
            - role
          additionalProperties: false
      required:
        - data
      additionalProperties: false
    ApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            details: {}
          required:
            - code
            - message
        requestId:
          type: string
      required:
        - error
        - requestId
  securitySchemes:
    WorkspaceKey:
      type: apiKey
      in: header
      name: x-chatobserver-key
      description: >-
        A workspace API key. Data endpoints require a service-account key with
        the specified scopes.
    BearerKey:
      type: http
      scheme: bearer
      description: The workspace or service-account API key as a bearer token.
    McpConnection:
      type: http
      scheme: bearer
      description: >-
        Delegated application credential issued after Chatobserver account
        consent. Restricted to selected workspaces and explicitly supported MCP
        operations. The MCP server access token is a separate credential and
        cannot be used here.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.