---
title: "Token"
method: POST
path: "/v1/oauth/token"
tags: ["oauth"]
---

# Token

`POST /v1/oauth/token`

## Request

- Base URL: `https://api.linktodm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.linktodm.com/v1/oauth/token`
- Auth: none declared

Exchange an authorization code, or rotate a refresh token.

## Headers

- `authorization` string, nullable

## Request body `application/x-www-form-urlencoded`

- BodyTokenV1OauthTokenPost
  - `grant_type` string, required
  - `code` string, nullable
  - `redirect_uri` string, nullable
  - `refresh_token` string, nullable
  - `scope` string, nullable
  - `code_verifier` string, nullable
  - `client_id` string, nullable
  - `client_secret` string, nullable

## Response `200`

Successful Response

- TokenResponse: RFC 6749 §5.1 token response.
  - `access_token` string, required
  - `token_type` 'bearer'
  - `expires_in` integer, required
  - `refresh_token` string, required
  - `scope` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/linktodm/apis/salesmorph.md) - [All operations](https://skmtc.dev/linktodm/apis/salesmorph/llms.txt) - [OpenAPI document](https://skmtc.dev/linktodm/apis/salesmorph/revisions/4af0ad5dbe92?raw)
