> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linguolink.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create access token

> Exchange a LinguLink API key for a short-lived Bearer access token (OAuth2 client-credentials grant). Send your API key as `client_secret`. Accepts JSON or form-encoded bodies. No authentication required — this is how you obtain a token.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/auth/token
openapi: 3.0.0
info:
  contact:
    email: support@linguolink.dev
    name: LinguLink Support
  description: Translation management API for LinguLink platform
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  title: LinguLink API v1
  version: 1.0.0
servers:
  - description: Development server
    url: http://localhost:3000
  - description: Production server
    url: https://linguolink.dev
security: []
tags:
  - description: API key authentication and validation
    name: Authentication
  - description: API key management operations
    name: API Keys
  - description: Translation management operations
    name: Translations
  - description: Endpoints the `lingulink` CLI's pull/push commands call
    name: CLI
  - description: Project metadata and translation coverage
    name: Projects
paths:
  /api/v1/auth/token:
    post:
      tags:
        - Authentication
      summary: Create access token
      description: >-
        Exchange a LinguLink API key for a short-lived Bearer access token
        (OAuth2 client-credentials grant). Send your API key as `client_secret`.
        Accepts JSON or form-encoded bodies. No authentication required — this
        is how you obtain a token.
      operationId: createAccessToken
      requestBody:
        content:
          application/json:
            schema:
              properties:
                client_id:
                  description: Optional label/identifier for the client.
                  example: my-app
                  type: string
                client_secret:
                  description: Your LinguLink API key.
                  example: ll_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
                  type: string
                grant_type:
                  enum:
                    - client_credentials
                  example: client_credentials
                  type: string
              required:
                - grant_type
                - client_secret
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  access_token:
                    type: string
                  expires_in:
                    example: 3600
                    type: integer
                  scope:
                    example: export:read translations:read
                    type: string
                  token_type:
                    example: Bearer
                    type: string
                required:
                  - access_token
                  - token_type
                  - expires_in
                  - scope
                type: object
          description: Access token issued
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  responses:
    BadRequest:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Bad request
    Unauthorized:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      description: Authentication required
  schemas:
    Error:
      properties:
        details:
          description: Additional error details (development only)
          type: string
        error:
          description: Error message
          type: string
        timestamp:
          description: Error timestamp
          format: date-time
          type: string
      required:
        - error
      type: object

````