> ## 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.

# Get One Workspace with the Caller's Current Role and Effective Permissions



## OpenAPI

````yaml https://quantura.studio/api/openapi.json get /workspaces/{workspace_id}
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}:
    get:
      tags:
        - Workspaces
      summary: >-
        Get One Workspace with the Caller's Current Role and Effective
        Permissions
      operationId: getWorkspace
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Effective workspace access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkspaceEnvelope'
              example:
                data:
                  id: ws_01JEXAMPLE9Y6Z
                  name: Institutional Research
                  slug: institutional-research
                  owner_user_id: usr_example_owner
                  role: owner
                  permissions:
                    - workspace.read
                    - csv.list
                    - csv.read
                    - csv.download
                  resource_scope:
                    csv:
                      mode: all
                      ids: []
                    forecasts:
                      mode: all
                      ids: []
                  capabilities:
                    - csv.read
                    - forecast.read
                  legacy_personal: false
                  created_at: '2026-09-03T14:30:00.000Z'
                  updated_at: '2026-09-03T14:30: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
        '404':
          description: Workspace not found.
        '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:
    WorkspaceEnvelope:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          $ref: '#/components/schemas/Workspace'
        meta:
          type: object
          properties:
            api_version:
              const: v1
    Workspace:
      type: object
      required:
        - id
        - name
        - owner_user_id
        - role
        - permissions
        - resource_scope
      properties:
        id:
          type: string
        name:
          type: string
        slug:
          type: string
        description:
          type: string
        owner_user_id:
          type: string
        role:
          type: string
          enum:
            - owner
            - admin
            - editor
            - analyst
            - viewer
            - custom
        permissions:
          type: array
          uniqueItems: true
          items:
            type: string
        resource_scope:
          $ref: '#/components/schemas/WorkspaceResourceScope'
        capabilities:
          type: array
          items:
            type: string
        legacy_personal:
          type: boolean
        created_at:
          type:
            - string
            - 'null'
          format: date-time
        updated_at:
          type:
            - string
            - 'null'
          format: date-time
        settings:
          type: object
          properties:
            default_csv_visibility:
              type: string
              enum:
                - workspace
                - private
            allow_member_invites:
              type: boolean
    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.