Mesh Connect Auth token API

openapi: 3.2.0
info:
  title: Admin Assets Auth token API
  version: v1
servers:
- url: https://admin-api.meshconnect.com
security:
- Bearer: []
tags:
- name: Auth token
paths:
  /admin/api/v1/Token:
    post:
      tags:
      - Auth token
      summary: Generate Auth token
      description: Get a short lived token for initializing request calls for Registered client API.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClientAdminTokenRequest'
            example:
              clientId: <api-key>
              clientSecret: <api-key>
          text/json:
            schema:
              $ref: '#/components/schemas/ClientAdminTokenRequest'
            example:
              clientId: <api-key>
              clientSecret: <api-key>
          application/*+json:
            schema:
              $ref: '#/components/schemas/ClientAdminTokenRequest'
            example:
              clientId: <api-key>
              clientSecret: <api-key>
      responses:
        '200':
          description: Token created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthTokenResponseApiResult'
              example:
                content:
                  id_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.KMUFsIDTnFmyG3nMiGM6H9FNFUROf3wh7SmqJp-QV30
                  expires_in: 3600
                  status: succeeded
                status: ok
                message: ''
                errorHash: e47df370
                teamCode: P4
                errorType: ''
        '400':
          description: Token request is not correct
          content:
            application/json:
              schema: {}
              example:
                status: badRequest
                message: Error message
                displayMessage: Optional display message
                errorHash: cd59bd31
                teamCode: P4
                errorType: missingField
        '403':
          description: 'Permission denied: Client Id or Client Secret are not correct or missing'
          content:
            application/json:
              schema: {}
              example:
                status: permissionDenied
                message: Error message
                displayMessage: Optional display message
                errorHash: cd59bd31
                teamCode: P4
                errorType: missingField
components:
  schemas:
    ApiResultStatus:
      enum:
      - ok
      - serverFailure
      - permissionDenied
      - badRequest
      - notFound
      - conflict
      - tooManyRequest
      - locked
      - unavailableForLegalReasons
      type: string
    OAuthTokenResponse:
      type: object
      properties:
        id_token:
          type:
          - string
          - 'null'
          description: Authentication token.
        expires_in:
          type:
          - integer
          - 'null'
          description: Expiration time in seconds.
          format: int64
        status:
          $ref: '#/components/schemas/AuthenticationStatus'
      additionalProperties: false
    ClientAdminTokenRequest:
      required:
      - clientId
      - clientSecret
      type: object
      properties:
        clientId:
          minLength: 1
          type: string
          description: Contact Mesh to get client Id.
        clientSecret:
          minLength: 1
          type: string
          description: Contact Mesh to get Client Secret for Account Management API.
      additionalProperties: false
      description: Generate Auth token.
    OAuthTokenResponseApiResult:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/ApiResultStatus'
        message:
          type:
          - string
          - 'null'
          description: A message generated by the API
        displayMessage:
          type:
          - string
          - 'null'
          description: User-friendly display message that can be presented to the end user
        errorHash:
          type:
          - string
          - 'null'
          description: An error grouping hash from string components and caller information. Used by bugsnag on FE for correct error grouping
          readOnly: true
        teamCode:
          type:
          - string
          - 'null'
          description: 'Opaque team code for error routing. Resolved from exception origin or caller file path via CODEOWNERS.

            Format: 2-character code (e.g., "7K", "M2"). Use for alerting/routing, not display.'
          readOnly: true
        errorType:
          type:
          - string
          - 'null'
          description: 'Strictly-typed error type that is explaining the reason of an unsuccessful status of the operation.

            All possible error types are available in the documentation.'
        errorData:
          readOnly: true
        content:
          $ref: '#/components/schemas/OAuthTokenResponse'
      additionalProperties: false
    AuthenticationStatus:
      enum:
      - failed
      - succeeded
      - mfaRequired
      - available
      type: string
  securitySchemes:
    Bearer:
      type: http
      description: 'Authorization header using the Bearer scheme. Example: "Authorization: Bearer {Value}"'
      scheme: bearer