---
title: "Refresh a token"
method: POST
path: "/auth/refresh-token"
tags: ["Authentication"]
---

# Refresh a token

`POST /auth/refresh-token`

## Headers

- `organization` string, required

## Response `201`

Token refreshed

- ResponseRefreshTokenOutput
  - `refreshToken` RefreshTokenResponseDto, required
    - `id` string, required
    - `accessToken` string, required
    - `firebaseToken` string, required
    - `created_at` string, date-time, required
  - `account` ResponseAccountOutput, required
    - `id` string — Account ID
    - `display_name` string — Display Name
    - `username` string — Username
    - `first_name` string — First Name
    - `last_name` string — Last name
    - `email` string — Contact email address
    - `status` ResponseAccountStatusOutput
      - `active` boolean, nullable, required — The account is active.
      - `block_temp` string, date-time, nullable, required — The account is temporarily blocked until this date.
      - `block_perm` boolean, nullable, required — The account is permanently blocked.
      - `pending_activation` boolean, nullable, required — The account is pending activation.
      - `gdpr` boolean, nullable, required — The account has GDPR requirements.
    - `organization` string — Organization ID
    - `roles` array[] — Roles
      - RolesDto[]
        - `id` string, required — Role ID
        - `permissions` PermissionDto[], required — Permissions
          - `id` string, required — Permission ID
          - `name` string, required — Permission name
          - `description` string, required — Permission description
          - `subject` SubjectDto, required
            - `id` string — Subject ID
            - `fields` string[] — Fields
            - `entity` string — Entity identified by this subject
          - `actions` string[], required — The actions that this permission allows to be performed on the subject
        - `name` string, required — Role name
        - `description` string, required — Role description
        - `public` boolean, required — If **True**, this role is available to all user, including those that are not logged it.
        - `default` boolean, required — If **True**, this role is assigned to any newly created organization.
    - `channels` ObjectId[] — Channels
    - `is_admin` boolean — Admin account
    - `is_tenant_user` boolean — The account is the owner of the organization
    - `is_super_user` boolean — Super user

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)