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

# Add an Existing Quantura User as a Workspace Collaborator



## OpenAPI

````yaml https://quantura.studio/api/openapi.json post /workspaces/{workspace_id}/collaborators
openapi: 3.1.0
info:
  title: Quantura Forecast Intelligence API
  version: 1.0.0
  description: >-
    Versioned access to Quantura forecasts, collaborator-aware workspaces,
    screeners, datasets, and provenance metadata.
  contact:
    name: Quantura
    url: https://quantura.studio/contact
  license:
    name: Quantura API Terms
    url: https://quantura.studio/terms
servers:
  - url: https://quantura.studio/api/v1
security:
  - bearerAuth: []
tags:
  - name: Access
    description: Identity, token scopes, plans, and effective workspace access.
  - name: Workspaces
    description: Resources are authorized against current membership on every request.
  - name: Uploaded CSVs
    description: Workspace-isolated CSV metadata, organization, and authorized exports.
  - name: Datasets
    description: Licensing-aware catalog and schema metadata.
  - name: Forecasts
    description: Prospective forecasts and immutable probability trajectories.
  - name: Ensemble Forecasts
    description: >-
      Asynchronous probabilistic time-series ensemble jobs and reproducible
      presets.
  - name: Backtests
    description: >-
      Asynchronous point-in-time ensemble-quantile simulations and versioned
      strategy exports; never live order execution.
paths:
  /workspaces/{workspace_id}/collaborators:
    post:
      tags:
        - Workspaces
      summary: Add an Existing Quantura User as a Workspace Collaborator
      operationId: addWorkspaceCollaborator
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkspaceMembershipMutation'
      responses:
        '201':
          description: Collaborator added.
          content:
            application/json:
              schema:
                type: object
              example:
                data:
                  id: member_01JEXAMPLE
                  user_id: usr_example_analyst
                  email: analyst@example.com
                  display_name: Example Analyst
                  role: analyst
                  permissions:
                    - workspace.read
                    - csv.list
                    - csv.read
                    - csv.download
                    - forecast.read
                    - forecast.create
                  resource_scope:
                    csv:
                      mode: all
                      ids: []
                    forecasts:
                      mode: all
                      ids: []
                  status: active
                  added_at: '2026-09-03T15:00:00.000Z'
                  updated_at: '2026-09-03T15:00:00.000Z'
                meta:
                  api_version: v1
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
        '403':
          description: Scope, plan, or workspace authorization denied
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
        '409':
          description: Membership conflict.
        '422':
          description: Invalid or ungrantable role, permission, or resource scope.
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                      - request_id
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      request_id:
                        type: string
                        format: uuid
components:
  schemas:
    WorkspaceMembershipMutation:
      type: object
      additionalProperties: false
      properties:
        email:
          type: string
          format: email
        role:
          type: string
          enum:
            - admin
            - editor
            - analyst
            - viewer
            - custom
          default: viewer
        permissions:
          type: array
          uniqueItems: true
          items:
            type: string
        resource_scope:
          $ref: '#/components/schemas/WorkspaceResourceScope'
        status:
          type: string
          enum:
            - active
            - removed
    WorkspaceResourceScope:
      type: object
      additionalProperties: false
      properties:
        csv:
          type: object
          additionalProperties: false
          required:
            - mode
            - ids
          properties:
            mode:
              type: string
              enum:
                - all
                - selected
                - none
            ids:
              type: array
              uniqueItems: true
              maxItems: 1000
              items:
                type: string
        forecasts:
          type: object
          additionalProperties: false
          required:
            - mode
            - ids
          properties:
            mode:
              type: string
              enum:
                - all
                - selected
                - none
            ids:
              type: array
              uniqueItems: true
              maxItems: 1000
              items:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Quantura API key

````

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