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

# Refresh Token

> Issue a new access token before the current one expires.

This endpoint allows clients to extend their session without re-authenticating.
The current token must still be valid to obtain a new one.



## OpenAPI

````yaml /api-reference/openapi.json post /api/auth/token/refresh
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
tags:
  - name: Authentication
  - name: Single sign-on
  - name: Social sign-in
  - name: SCIM provisioning
  - name: Projects
  - name: Datasets
  - name: Uploads and imports
  - name: Scans
  - name: Schedules
  - name: Healing
  - name: RAG corpora
  - name: Custom rules
  - name: Playground
  - name: Search and activity
  - name: Apps
  - name: Devices and agents
  - name: Discovery
  - name: DLP policy
  - name: DLP installation
  - name: Compliance
  - name: Audit trail
  - name: Reports
  - name: Export templates
  - name: Workspaces
  - name: Users
  - name: Invitations
  - name: API keys
  - name: Settings
  - name: Directory sync
  - name: Integrations
  - name: Pending actions
  - name: License
  - name: Onboarding
  - name: Support
  - name: Platform operations
  - name: Webhooks
paths:
  /api/auth/token/refresh:
    post:
      tags:
        - Authentication
      summary: Refresh Token
      description: >-
        Issue a new access token before the current one expires.


        This endpoint allows clients to extend their session without
        re-authenticating.

        The current token must still be valid to obtain a new one.
      operationId: refresh_token_api_auth_token_refresh_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenResponse'
components:
  schemas:
    TokenResponse:
      properties:
        access_token:
          type: string
          title: Access Token
        token_type:
          type: string
          title: Token Type
          default: bearer
        expires_in:
          type: integer
          title: Expires In
        user:
          $ref: '#/components/schemas/UserRead'
        roles:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Roles
      type: object
      required:
        - access_token
        - expires_in
        - user
      title: TokenResponse
    UserRead:
      properties:
        id:
          type: integer
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        email:
          type: string
          title: Email
        is_active:
          type: boolean
          title: Is Active
        roles:
          items:
            type: string
          type: array
          title: Roles
          default: []
        mfa_enabled:
          type: boolean
          title: Mfa Enabled
          default: false
        is_platform_owner:
          type: boolean
          title: Is Platform Owner
          default: false
        workspace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workspace Id
        workspace:
          anyOf:
            - $ref: '#/components/schemas/WorkspaceSummary'
            - type: 'null'
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
      type: object
      required:
        - id
        - email
        - is_active
      title: UserRead
    WorkspaceSummary:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        type:
          type: string
          title: Type
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
      type: object
      required:
        - id
        - name
        - slug
        - type
      title: WorkspaceSummary
      description: Compact workspace info embedded in auth payloads and user lists.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.