TetraScience

TetraScience Connectors API

The Connectors API from TetraScience — 23 operation(s) for connectors.

GitHub OpenAPI

Operations 23

GET /v1/data-acquisition/connectors Get all Connectors #
GET /v1/data-acquisition/connectors/{id} Get a Connector by id #
GET /v1/data-acquisition/connectors/{id}/metrics Get a Connector's metrics #
GET /v1/data-acquisition/connectors/{id}/files Get a Connector's reported files #
GET /v1/data-acquisition/connectors/{id}/files/stats Get statistics about a Connector's files #
GET /v1/artifacts/connectors/{namespace} List all Connectors for namespace #
GET /v1/artifacts/connectors/{namespace}/{slug} Returns a list of Connector artifacts given a namespace and slug #
GET /v1/artifacts/connectors/{namespace}/{slug}/{version}/files/{fileSlug} Get contents for an Connector file #
GET /v1/artifacts/connectors/{namespace}/{slug}/{version} Get single Connector #
GET /v1/artifacts/connectors/{namespace}/{slug}/{version}/files Get available file slugs for Connector #
GET /v1/artifacts/connectors/{namespace}/{slug}/{version}/labels Get labels for an Connector #
GET /v1/artifacts/connectors/{namespace}/{slug}/{version}/relationships Get artifacts related to Connector #
GET /v1/artifacts/connectors List all connectors artifacts #
GET /v1/artifacts/data-apps/{namespace} List all Data Apps for namespace #
GET /v1/artifacts/data-apps/{namespace}/{slug} Returns a list of Data App artifacts given a namespace and slug #
GET /v1/artifacts/data-apps/{namespace}/{slug}/{version}/files/{fileSlug} Get contents for a Data App file #
GET /v1/artifacts/data-apps/{namespace}/{slug}/{version} Get single Data App #
GET /v1/artifacts/data-apps/{namespace}/{slug}/{version}/files Get available file slugs for Data App #
GET /v1/artifacts/data-apps/{namespace}/{slug}/{version}/labels Get labels for a Data App #
GET /v1/artifacts/data-apps/{namespace}/{slug}/{version}/relationships Get artifacts related to Data App #
GET /v1/artifacts/data-apps List all connectors artifacts of sub-type data-app #
POST /v1/artifacts/connectors/search Search for items #
POST /v1/artifacts/data-apps/search Search for items #

Documentation

📖
Documentation
https://developers.tetrascience.com/
📖
GettingStarted
https://developers.tetrascience.com/docs/tetra-data-platform
📖
APIReference
https://developers.tetrascience.com/reference
📖
Authentication
https://developers.tetrascience.com/docs/api-tokens
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/rate-limits/tetrascience-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/openapi/tetrascience-connectors-api-openapi.yml

Other Resources

🔗
HumanURL
https://www.tetrascience.com/
🔗
ChangeLog
https://developers.tetrascience.com/docs/agent-release-notes
🔗
LlmsText
https://developers.tetrascience.com/llms.txt
🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/rules/tetrascience-rules.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/json-ld/tetrascience-context.jsonld
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/vocabulary/tetrascience-vocabulary.yml
🔗
SDKs
https://github.com/tetrascience/ts-scientific-data-and-ai-cloud-api-examples
🔗
PipelineExamples
https://github.com/tetrascience/ts-scientific-data-and-ai-cloud-pipeline-examples
🔗
ElasticsearchExamples
https://github.com/tetrascience/ts-scientific-data-and-ai-cloud-elasticsearch-examples
🔗
AgentMonitoring
https://github.com/tetrascience/ts-agent-monitoring
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/plans/tetrascience-plans-pricing.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/finops/tetrascience-finops.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tetrascience-connectors-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tetrascience-connectors-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TetraScience Data and AI Cloud Access Groups Connectors API
  version: '4.0'
  description: Programmatic access to the TetraScience Scientific Data and AI Platform — manage tenants, organizations, users, roles, agents, integrations, pipelines, files, datasets, schemas, and search across the Tetra Data Platform.
  contact:
    name: TetraScience
    url: https://www.tetrascience.com/
  license:
    name: Proprietary
servers:
- url: https://api.tetrascience.com
  description: Production Server
- url: https://api.tetrascience-uat.com
  description: User Acceptance Server
- url: https://api.tetrascience-dev.com
  description: Development Server
- url: https://api.tetrascience-uat.com
  description: User Acceptabce Server
- url: api.tetrascience.com
security:
- token: []
  orgSlug: []
- orgSlug: []
  tsAuthToken: []
tags:
- name: Connectors
paths:
  /v1/data-acquisition/connectors:
    get:
      tags:
      - Connectors
      operationId: ConnectorController_getAll
      summary: Get all Connectors
      description: '**:warning: This is a new API which is still subject to change.**


        Use this endpoint to get a list of Connectors.'
      responses:
        '200':
          description: Successful response with a list of all Connectors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorsResponse'
  /v1/data-acquisition/connectors/{id}:
    get:
      tags:
      - Connectors
      operationId: ConnectorController_getById
      summary: Get a Connector by id
      description: '**:warning: This is a new API which is still subject to change.**


        Use this endpoint to get a Connector''s details by id.'
      parameters:
      - name: id
        description: The Connector's id.
        required: true
        in: path
        schema:
          type: string
      - name: resolveSecrets
        description: If true, resolves secrets in the Connector's config. Requires organization admin permissions.
        required: false
        in: query
        schema:
          type: boolean
      - name: include
        description: Include additional Connector fields. 'config' includes the Connector's config. 'artifact' includes the Connector artifact's details.
        required: false
        in: query
        example:
        - config
        schema:
          type: array
          items:
            type: string
            enum:
            - config
            - artifact
      responses:
        '200':
          description: Successful response with a Connector's details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorDetailsDto'
  /v1/data-acquisition/connectors/{id}/metrics:
    get:
      tags:
      - Connectors
      operationId: ConnectorController_getFileMetrics
      summary: Get a Connector's metrics
      description: '**:warning: This is a new API which is still subject to change.**


        Use this endpoint to get the metrics reported by a Connector, including resource usage and file upload and error rates.'
      parameters:
      - name: id
        description: The Connector's id.
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Successful response with the metrics reported by a Connector
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectorMetricsDto'
  /v1/data-acquisition/connectors/{id}/files:
    get:
      tags:
      - Connectors
      operationId: ConnectorController_getFiles
      summary: Get a Connector's reported files
      description: '**:warning: This is a new API which is still subject to change.**


        Use this endpoint to get metadata about the files reported by a Connector, including those that have not yet been uploaded or that have failed.'
      parameters:
      - name: id
        description: The Connector's id.
        required: true
        in: path
        schema:
          type: string
      - name: fileIds
        description: A list of file ids to filter by.
        required: false
        in: query
        schema:
          type: array
          items:
            type: string
      - name: excludeFileIds
        description: A list of file ids to exclude from the response.
        required: false
        in: query
        schema:
          type: array
          items:
            type: string
      - name: uniqueExternalIds
        description: A list of unique external ids to filter by. Used by Connectors to deduplicate external files.
        required: false
        in: query
        schema:
          type: array
          items:
            type: string
      - name: excludeUniqueExternalIds
        description: A list of unique external ids to exclude from the response. Used by Connectors to deduplicate external files.
        required: false
        in: query
        schema:
          type: array
          items:
            type: string
      - name: statuses
        description: A list of file statuses to filter by.
        required: false
        in: query
        schema:
          type: array
          items:
            type: string
            enum:
            - PENDING
            - PROCESSING
            - SKIPPED
            - SUCCESS
            - ERROR
      - name: maxErrors
        description: The maximum number of errors to filter by. Used by Connectors to limit file upload retries.
        required: false
        in: query
        schema:
          type: number
      - name: createdBefore
        description: The maximum creation date to filter by.
        required: false
        in: query
        schema:
          format: date-time
          type: string
      - name: createdAfter
        description: The minimum creation date to filter by.
        required: false
        in: query
        schema:
          format: date-time
          type: string
      - name: updatedBefore
        description: The maximum update date to filter by.
        required: false
        in: query
        schema:
          format: date-time
          type: string
      - name: updatedAfter
        description: The minimum update date to filter by.
        required: false
        in: query
        schema:
          format: date-time
          type: string
      - name: orderBy
        description: The field to order by.
        required: false
        in: query
        schema:
          type: string
          enum:
          - filepath
          - status
          - errorCount
          - updatedAt
          - createdAt
      - name: orderDirection
        description: The order direction.
        required: false
        in: query
        schema:
          enum:
          - ASC
          - DESC
          type: string
      - name: take
        description: The number of files to take. Default is 50.
        required: false
        in: query
        schema:
          type: number
          default: 50
      - name: skip
        description: The number of files to skip.
        required: false
        in: query
        schema:
          type: number
          default: 0
      responses:
        '200':
          description: Successful response with a list of files reported by a Connector
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorFilesResponse'
  /v1/data-acquisition/connectors/{id}/files/stats:
    get:
      tags:
      - Connectors
      operationId: ConnectorController_getFileStats
      summary: Get statistics about a Connector's files
      description: '**:warning: This is a new API which is still subject to change.**


        Use this endpoint to get the file statistics reported by a Connector, including the total number of files and the number of files in each status.'
      parameters:
      - name: id
        description: The Connector's id.
        required: true
        in: path
        schema:
          type: string
      responses:
        '200':
          description: Successful response with the file stats reported by a Connector
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectorFileStatsDto'
  /v1/artifacts/connectors/{namespace}:
    get:
      description: Returns a list of all Connector artifacts given a namespace
      summary: List all Connectors for namespace
      tags:
      - Connectors
      operationId: getConnectorArtifactByNamespace
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}:
    get:
      description: Returns a list of all Connector artifacts given a namespace and slug
      summary: Returns a list of Connector artifacts given a namespace and slug
      tags:
      - Connectors
      operationId: getConnectorArtifactByNamespaceAndSlug
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}/{version}/files/{fileSlug}:
    get:
      description: Returns the file contents for an Connector file given a namespace, slug, version, and file slug
      summary: Get contents for an Connector file
      tags:
      - Connectors
      operationId: getConnectorArtifactByNamespaceSlugAndFileSlug
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/ConnectorFileSlugParam'
      - $ref: '#/components/parameters/DownloadQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200File'
        '400':
          $ref: '#/components/responses/400Any'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}/{version}:
    get:
      description: Returns a single Connector artifact matching the namespace, slug, and version
      summary: Get single Connector
      tags:
      - Connectors
      operationId: getConnectorArtifactByNamespaceSlugAndVersion
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObject'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}/{version}/files:
    get:
      description: Returns which file slugs are available to retrieve for this Connector
      summary: Get available file slugs for Connector
      tags:
      - Connectors
      operationId: getConnectorArtifactFileSlugs
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorFileSlugList'
        '400':
          $ref: '#/components/responses/400Any'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}/{version}/labels:
    get:
      description: Returns a list of the labels associated with a Connector artifact
      summary: Get labels for an Connector
      tags:
      - Connectors
      operationId: getConnectorArtifactLabels
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200Labels'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/{namespace}/{slug}/{version}/relationships:
    get:
      description: Returns a list of the relationships a Connector artifact has with other artifacts
      summary: Get artifacts related to Connector
      tags:
      - Connectors
      operationId: getConnectorArtifactRelationships
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200Relationships'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors:
    get:
      description: Returns a list of all Connector artifacts, optionally filtered by namespace type
      summary: List all connectors artifacts
      tags:
      - Connectors
      operationId: getConnectorArtifacts
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespaceTypeQuery'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
  /v1/artifacts/data-apps/{namespace}:
    get:
      description: Returns a list of all Data App artifacts given a namespace
      summary: List all Data Apps for namespace
      tags:
      - Connectors
      operationId: getDataAppArtifactByNamespace
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}:
    get:
      description: Returns a list of all Data App artifacts given a namespace and slug
      summary: Returns a list of Data App artifacts given a namespace and slug
      tags:
      - Connectors
      operationId: getDataAppArtifactByNamespaceAndSlug
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}/{version}/files/{fileSlug}:
    get:
      description: Returns the file contents for an Data App file given a namespace, slug, version, and file slug
      summary: Get contents for a Data App file
      tags:
      - Connectors
      operationId: getDataAppArtifactByNamespaceSlugAndFileSlug
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/ConnectorFileSlugParam'
      - $ref: '#/components/parameters/DownloadQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200File'
        '400':
          $ref: '#/components/responses/400Any'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}/{version}:
    get:
      description: Returns a single Data App artifact matching the namespace, slug, and version
      summary: Get single Data App
      tags:
      - Connectors
      operationId: getDataAppArtifactByNamespaceSlugAndVersion
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObject'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}/{version}/files:
    get:
      description: Returns which file slugs are available to retrieve for this Data App
      summary: Get available file slugs for Data App
      tags:
      - Connectors
      operationId: getDataAppArtifactFileSlugs
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorFileSlugList'
        '400':
          $ref: '#/components/responses/400Any'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}/{version}/labels:
    get:
      description: Returns a list of the labels associated with a Data App artifact
      summary: Get labels for a Data App
      tags:
      - Connectors
      operationId: getDataAppArtifactLabels
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200Labels'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps/{namespace}/{slug}/{version}/relationships:
    get:
      description: Returns a list of the relationships a Data App artifact has with other artifacts
      summary: Get artifacts related to Data App
      tags:
      - Connectors
      operationId: getDataAppArtifactRelationships
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespace'
      - $ref: '#/components/parameters/ArtifactSlug'
      - $ref: '#/components/parameters/ArtifactVersion'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200Relationships'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/data-apps:
    get:
      description: Returns a list of all Connector artifacts that can be deployed as a data app, optionally filtered by namespace type
      summary: List all connectors artifacts of sub-type data-app
      tags:
      - Connectors
      operationId: getDataAppArtifacts
      parameters:
      - $ref: '#/components/parameters/ArtifactNamespaceTypeQuery'
      - $ref: '#/components/parameters/LatestOnlyQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          $ref: '#/components/responses/200ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
  /v1/artifacts/connectors/search:
    post:
      summary: Search for items
      description: Search for items using specified criteria
      tags:
      - Connectors
      operationId: searchConnectors
      parameters:
      - $ref: '#/components/parameters/ValueQuery'
      - $ref: '#/components/parameters/LimitQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          description: A list of items that match the search query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorObjectList'
  /v1/artifacts/data-apps/search:
    post:
      summary: Search for items
      description: Search for items using specified criteria
      tags:
      - Connectors
      operationId: searchDataApps
      parameters:
      - $ref: '#/components/parameters/ValueQuery'
      - $ref: '#/components/parameters/LimitQuery'
      - $ref: '#/components/parameters/IncludePrereleasesQuery'
      responses:
        '200':
          description: A list of items that match the search query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectorObjectList'
        '404':
          $ref: '#/components/responses/404Any'
components:
  schemas:
    LabelList:
      type: array
      items:
        type: object
        properties:
          name:
            type: string
          value:
            type: string
        required:
        - name
        - value
        additionalProperties: false
      example:
      - name: label1
        value: value1
      - name: another-label
        value: another-value
    HubStatusDto:
      type: object
      properties:
        health:
          description: The health status of the Hub.
          type: object
          properties:
            breakdown:
              type: array
              items:
                type: object
                properties:
                  name:
                    type: string
                    enum:
                    - Availability
                    - CPU
                    - Disk
                    - Memory
                    - ProxyMemory
                    - ProxyMemoryMax
                    - ProxyAvailability
                  status:
                    type: string
                    enum:
                    - HEALTHY
                    - WARNING
                    - CRITICAL
            status:
              type: string
              description: The overall health status of the Hub. Rolls up to the most severe status in the breakdown.
              enum:
              - HEALTHY
              - WARNING
              - CRITICAL
        network:
          description: The network status of the Hub.
          type: string
          enum:
          - Online
          - Offline
          - Never Seen
        lastSeen:
          description: The last time the Hub was seen by the platform.
          format: date-time
          type: string
        metrics:
          type: array
          items:
            type: object
            properties:
              cpuUsedSystem:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Percent
              cpuUsedUser:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Percent
              diskFree:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              diskUsed:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Percent
              memoryUsed:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryFree:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryBuffered:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryCached:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryAvailable:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryTotal:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
              memoryUsedPercentOfReservation:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Percent
              memoryMax:
                type: object
                properties:
                  value:
                    type: number
                  unit:
                    type: string
                    enum:
                    - Bytes
        proxies:
          description: The status of the Hub's built-in Agent proxies.
          type: object
          properties:
            l7:
              type: object
              properties:
                startedAt:
                  type: string
                  format: date-time
                status:
                  type: string
                  enum:
                  - RUNNING
                  - STOPPED
            l7ReverseNginx:
              type: object
              properties:
                startedAt:
                  type: string
                  format: date-time
                status:
                  type: string
                  enum:
                  - RUNNING
                  - STOPPED
            l7ReverseSocat:
              type: object
              properties:
                startedAt:
                  type: string
                  format: date-time
                status:
                  type: string
                  enum:
                  - RUNNING
                  - STOPPED
            metrics:
              type: array
              items:
                type: object
                properties:
                  cpuUsed:
                    type: object
                    properties:
                      value:
                        type: number
                      unit:
                        type: string
                        enum:
                        - Percent
                  memoryUsed:
                    type: object
                    properties:
                      value:
                        type: number
                      unit:
                        type: string
                        enum:
                        - Bytes
                  memoryUsedPercentOfMax:
                    type: object
                    properties:
                      value:
                        type: number
                      unit:
                        type: string
                        enum:
                        - Percent
                  memoryUsedPercentOfReservation:
                    type: object
                    properties:
                      value:
                        type: number
                      unit:
                        type: string
                        enum:
                        - Percent
                  memoryMax:
                    type: object
                    properties:
                      value:
                        type: number
                      unit:
                        type: string
                        enum:
                        - Bytes
      required:
      - network
      - lastSeen
      - proxies
      - metrics
      - health
    ConnectorFilesResponse:
      type: object
      description: A list of files reported by a Connector.
      properties:
        files:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorFileDto'
        total:
          type: number
      required:
      - files
      - total
    ConnectorDto:
      type: object
      description: Details of a single Connector
      properties:
        id:
          description: The Connector's id.
          type: string
        name:
          description: The Connector's name.
          type: string
        orgSlug:
          description: The organization slug that the Connector belongs to.
          type: string
        description:
          description: The Connector's description.
          type: string
        artifact:
          $ref: '#/components/schemas/ArtifactDto'
        hostType:
          description: The type of host the Connector is running on.
          type: string
          enum:
          - cloud
          - hub
        hub:
          $ref: '#/components/schemas/HubDto'
        metadata:
          type: object
        tags:
          type: array
          items:
            type: string
        commandQueue:
          description: The ARN of the Connector's command queue.
          type: string
        clusterArn:
          description: The ARN of the ECS cluster the Connector is running in.
          type: string
        taskDefinitionArn:
          description: The ARN of the ECS task definition the Connector is running.
          type: string
        health:
          description: The health status of the Connector. N/A indicates the Connector has never reported health.
          type: string
          enum:
          - HEALTHY
          - WARNING
          - CRITICAL
          - N/A
        healthErrorCode:
          description: The error code of the Connector's health status, if unhealthy. Defined by each Connector and used to display an error message in the UI.
          type: string
        operatingStatus:
          description: The desired operating status of the Connector. RUNNING means the Connector is fully working; IDLE means the Connector software is running and awaiting commands, but is not performing its main (Connector-defined) work yet; DISABLED means the software is not running at all.
          type: string
          enum:
          - IDLE
          - RUNNING
          - DISABLED
        networkStatus:
          description: The network status of the Connector.
          type: string
          enum:
          - Online
          - Offline
        config:
          description: The Connector's current configuration, schema varies per Connector.
          type: object
        lastSeenAt:
          description: The last time the Connector was seen by the platform.
          format: date-time
          type: string
        updatedAt:
          description: The last time the Connector's details were updated.
          format: date-time
          type: string
        createdAt:
          description: The time the Connector was created.
          format: date-time
          type: string
      required:
      - id
      - name
      - orgSlug
      - artifact
      - hostType
      - metadata
      - tags
      - commandQueue
      - clusterArn
      - taskDefinitionArn
      - health
      - operatingStatus
      - networkStatus
      - lastSeenAt
      - updatedAt
      - createdAt
    GetConnectorMetricsDto:
      type: object
      description: The set of metrics reported by the Connector.
      properties:
        metrics:
          type: array
          items:
            $ref: '#/components/schemas/ConnectorMetricDto'
      required:
      - metrics
    SupportedPlatformVersion:
      type: object
      nullable: true
      properties:
        minPlatformVersion:
          type: string
          nullable: false
        maxPlatformVersion:
          type: string
          nullable: true
    Connect

# --- truncated at 32 KB (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tetrascience/refs/heads/main/openapi/tetrascience-connectors-api-openapi.yml