# Flowg8 · Access-Token erneuern

Erneuere den Zugriff, ohne dein Passwort erneut zu senden.

Nutze den bei der Anmeldung zurückgegebenen Refresh-Token. Bearer-Token und Organisationsheader sind nicht erforderlich. Ersetze einen erneut gelieferten refreshToken atomar; fehlt er, behalte den bisherigen. Die Erneuerung erweitert weder Mitgliedschaft noch Adminrechte. Bei 401 musst du dich erneut authentifizieren. Flowg8 speichert diese Tokens nicht.

## POST /v1/auth/token

Authentication: public account endpoint; no token required
Required user permissions: Keine Kontorolle erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Input parameters
- grantType (string, required): refresh_token
- refreshToken (string, required): min length 1 · max length 4096

## Request example (replace example IDs)

```sh
curl -X POST "https://api.flowg8.io/v1/auth/token" \
  -H "content-type: application/json" \
  --data-raw '{
  "grantType": "refresh_token",
  "refreshToken": "YOUR_REFRESH_TOKEN"
}'
```

## Response excerpt

```json
{
  "status": "authenticated",
  "tokenType": "Bearer",
  "accessToken": "YOUR_FLOWG8_ACCESS_TOKEN",
  "expiresIn": 3600,
  "expiresAt": "2026-10-17T12:00:00.000Z"
}
```

Source: /docs/refresh-token
Full schemas: /docs/openapi.json
