> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Token


> Create Session Token




## OpenAPI

````yaml /openapi/scx/auth.json post /v1/auth
openapi: 3.0.2
info:
  title: SCX Authentication API
  version: '1.0'
  x-logo:
    url: https://scx-sandbox.ui.jtl-software.com/docs/scx.png
  description: |
    SCX Authentication API
servers:
  - url: https://scx-sbx.api.jtl-software.com
    description: Sandbox Environment
security: []
tags:
  - name: Authentication
    description: Authentication and access token management
paths:
  /v1/auth:
    post:
      tags:
        - Authentication
      summary: |
        Session Token
      description: |
        Create Session Token
      operationId: Authenticate
      requestBody:
        description: Refresh token used to obtain a new short-lived session (access) token.
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                refreshToken:
                  type: string
                  example: SELLER:0eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ
      responses:
        '200':
          $ref: '#/components/responses/AuthToken'
        '400':
          $ref: '#/components/responses/BadRequest'
        '426':
          $ref: '#/components/responses/RequestThrottled'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    AuthToken:
      description: |
        Create new Auth Token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AuthToken'
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseList'
          example:
            errorList:
              - code: VAL100
                message: Required field sellerId not found
                severity: error
                hint: Check the field `sellerId` — it must be a non-empty string.
    RequestThrottled:
      description: User has send to many requests
    ServerError:
      description: Unexpected Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponseList'
          example:
            errorList:
              - code: GEN500
                message: Internal Server Error
                severity: error
                hint: null
  schemas:
    AuthToken:
      description: >
        Issued session credentials returned by the auth endpoint. Contains the
        bearer token,

        its scope (seller, channel, or admin), and absolute/relative expiry
        timestamps.
      properties:
        scope:
          type: string
          enum:
            - SELLER
            - CHAN
            - ADM
          example: SELLER
        authToken:
          type: string
          example: >-
            eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhY2NvdW50SWQiOiIxNDU3IiwiaWF0IjoxNTE2MjM5MDIyfQ.uWKi0yGrf35hapLiNAb1QHpQ5dLJ7hyUg8_R6GU6RzU
        tokenExpireAt:
          type: string
          format: date-time
          example: '2036-04-01T12:00:00+00:00'
        expiresIn:
          type: integer
          example: 360
    ErrorResponseList:
      type: object
      properties:
        errorList:
          nullable: true
          type: array
          example:
            - code: GEN700
              message: Seller SELLER_4711 does not exist on channel kaufland.
              severity: error
              hint: i9n-order22
          items:
            title: Error
            type: object
            properties:
              code:
                type: string
                example: GEN700
              message:
                type: string
                example: Seller SELLER_4711 does not exist on channel kaufland.
              severity:
                type: string
                enum:
                  - error
                  - warning
                  - info
                default: error
              hint:
                type: string
                nullable: true
                example: i9n-order22

````