openapi: 3.1.0
info:
  title: Tonic Structural REST Generate Data Workspaces API
  version: '1.0'
  description: 'REST API for Tonic Structural, the de-identification, subsetting,

    and synthetic data product from Tonic.ai. The API surface exposes

    workspaces, generation jobs, and table relationship management.


    Authentication uses an API key passed via the `Authorization` header

    in the form `Authorization: Apikey <token>`. API tokens are created

    from User Settings and do not expire.


    Sources:

    - https://docs.tonic.ai/app/api/api-documentation

    - https://docs.tonic.ai/app/api/api-examples

    - Per-instance Swagger at /apidocs/index.html on each Tonic host.

    '
  contact:
    name: Tonic.ai
    url: https://docs.tonic.ai/app/api/api-documentation
servers:
- url: https://{tonicHost}
  description: Your Tonic Structural instance
  variables:
    tonicHost:
      default: app.tonic.ai
      description: Hostname of your Tonic Structural deployment.
security:
- apiKeyAuth: []
tags:
- name: Workspaces
paths:
  /api/workspace:
    get:
      tags:
      - Workspaces
      summary: List workspaces
      operationId: listWorkspaces
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      responses:
        '200':
          description: Array of workspaces accessible to the caller.
components:
  parameters:
    ApiVersion:
      in: query
      name: api-version
      required: true
      schema:
        type: string
      description: 'Tonic API version (for example `v2023.07.0`). Required on every

        request unless a default version is configured.

        '
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'Tonic API key. Send as `Authorization: Apikey <token>`.

        '