---
id: refresh-access-token
title: "Refresh access token"
description: "Allows clients to obtain a new access token using a previously issued refresh token. This mechanism supports session continuation without requiring the user to re-authenticate."
sidebar_label: "Refresh access token"
hide_title: true
hide_table_of_contents: true
api: eJzVVcFu20YQ/ZXBnFqAomwjKVCe6jhuIKNNAttJCjg+jJYjceLlLrO7lKwKuvVL+mn9kmKWdCzbQVsUvdQXU8uZ4bz3Zt5uMdEyYnWFx31q2CUxlMQ7vC6w5miCdPlnhcfW+nUEY4VdipA8+HkicUDgeA1kDEc9vmEHfRS3BIIu8Ep8H+0GJMaeawi8CBybIa6Ey0YitGwachJbiH3X+ZAiRI5RvAPjXRLX55ZgLanxfYLAn3sJ+oXUMPSRg3YTeEL3ELjEAjWQY3rh6w1WW9Ri7JI+UtfZEen0U1R8W4ym4Zb0KW06xgr9/BObhAV2wXccknDUtyOEvcCYtBt8whisyMpjzFgg31LbWc3kzVkzf2XkjZzN3v06O3wtszhz58/Nyey72U33y/uTs+/LssTdbkAjgWsV666H691ueBU77+LQ39HBgf572Ms5pz64+BWxtKH/iJmh7N8T85rXcPbh8kEb/5KWAf+zr0G+bPgh9SARxA2a+AANReDbTiktMRc5fFrkZ4l5ln2AluzCh/bJEGdxWk6Nr7HCzsdMDKUGK5zqSE5z3HTMmmKBkcOKg67dFvtgscImpS5W02kdVpN57+pJ3pcwUWWCt5bDhDopZRnIpVI87q61jOmDpM2F6jNIMGcKHHSX92TQ4vrVHIbVGITF+PCjDy0lrPDsw2UGo7qf3+/O6Z0ue7P/zyUqUNzC524kZXVfnr+HF72r4eQLODh+O4OX3vQtuzQYUIFK0aDC0cHR8/JZeTiOKpk8qtySKHeja/xwT06BjjJSeXV/9JDoPSYfj+eXJPjmj99+/1bHhuBizbXEBmpKBHyrjrVkIFfDioMsxpUBVVYMQxf8SmoOJcySWpRaml1Mol9xYFk6kFqdKm2KMZ/mlsEEzsdkYwEEtSwlkYU1Wcspfyx6nd7O15DYNM5bvxSOBbCjuR1MVxfc8oot+AWIS5x3lOZiJW1yEeqTbylpuPFtZ4Wc4WyvA7zAy95mPLowQLDord0A9bWk3GdLznFQ57Bi2MU8GyPlxx2ZhuGoPHjC+Xq9Lim/Ln1YTsfcOP1pdnL6+uJ0ojk6f7pDLbm9oufjxj1yjAe67Rn8//GyGnc18W2adpbE6WBm/rajm1yh5mjoCP9uGwvU67pR56mucLudU+R3we52evy557DB6uq6wBWFPGf6a1dgw1RzyCZ0wxus8GTgb3KprWi47bWlJ1fCrrjLODaGu/SXsdd75vj2zcWl2s54Ibe+1pxAawVDa6zwI35ELNBnTYfrVs+3aMkte1pq/FBX//4E0QEPVw==
sidebar_class_name: "post api-method"
info_path: docs/drv-bund-api/drv-bund-controller-api-documentation
custom_edit_url: null
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```


import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Markdown from "@theme/Markdown";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Refresh access token</h1>

<MethodEndpoint method={"post"} path={"/auth/token/refresh/"}></MethodEndpoint>



Allows clients to obtain a new access token using a previously issued refresh token. This mechanism supports session continuation without requiring the user to re-authenticate.

## Request

<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"refresh"} required={true} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"A valid refresh token.","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}}></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs label={undefined} id={undefined}><TabItem label={"200"} value={"200"}><div>

Returns a new access token.

</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"access"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","description":"New JWT access token","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"access\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>

The refresh token is invalid or has expired.

</div><div></div></TabItem><TabItem label={"401"} value={"401"}><div>

Missing or malformed refresh token.

</div><div></div></TabItem></ApiTabs></div></div>