Tenyks Auth API

openapi: 3.2.0
info:
  title: Tenyks Auth API
  version: 1.0.1
  description: The Tenyks API is the programmatic backbone of the Tenyks visual-intelligence / MLOps platform for computer-vision teams. It lets you authenticate with an API key + secret to obtain a short-lived Bearer access token, then create datasets and models, upload annotations and predictions from cloud storage (AWS S3, GCS, Azure), and trigger ingestion. Currently an alpha API available to Premium (Dashboard) users; a Sandbox host is available for the freemium tier.
  x-alpha: true
  contact:
    name: Tenyks
    url: https://www.tenyks.ai/
servers:
- url: https://{base_url}.tenyks.ai
  description: The Tenyks API
  variables:
    base_url:
      enum:
      - dashboard
      - sandbox
      default: dashboard
tags:
- name: Auth
  description: Obtain a Bearer access token from an API key and secret.
paths:
  /api/auth/apikey:
    post:
      tags:
      - Auth
      operationId: generateAccessToken
      summary: Generate Access Token
      description: This endpoint generates an access token to be used as a Bearer token on all the other endpoints. The token_type is Bearer and expires_in is 3600 seconds.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiKeyPayload'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccessTokenResponse'
        '400':
          description: Bad request
          content:
            application/json: {}
components:
  schemas:
    ApiKeyPayload:
      type: object
      properties:
        api_key:
          type: string
          description: Your Tenyks API key.
        api_secret:
          type: string
          description: Your Tenyks API secret.
      required:
      - api_key
      - api_secret
    AccessTokenResponse:
      type: object
      properties:
        access_token:
          type: string
          description: Time-limited Bearer token for subsequent requests.
        id_token:
          type: string
          description: JWT with information about the user and authentication event.
        expires_in:
          type: integer
          description: Seconds the access token is valid (3600).
          example: 3600
        token_type:
          type: string
          example: Bearer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer access token obtained from POST /api/auth/apikey (expires in 3600 seconds).
x-apievangelist:
  generated: '2026-07-21'
  method: searched
  source: https://docs.tenyks.ai/reference/ — assembled verbatim from the per-endpoint OpenAPI 3.0 definitions that Tenyks publishes on each ReadMe API-reference page (Auth, Datasets, Data Upload). operationIds added by API Evangelist for cross-referencing; paths, servers, schemas, security and request bodies are as published by the provider.
  note: Tenyks documents one OpenAPI fragment per reference page rather than a single combined document; this file merges the eight documented operations into one spec. The literal workspace segment 'tenyks' is the example workspace name used throughout the provider's reference.