---
title: "Create a token"
method: POST
path: "/api/v3/token"
tags: ["Authentication"]
---

# Create a token

`POST /api/v3/token`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/token`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/token/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates and returns new access token for operating against workspace resources.

## Request body

- object
  - `workspace_id` integer: Workspace ID

## Response `200`

Create a Token

- object
  - `token` string: Token

## Other responses

- `400`: Bad Request
- `401`: Forbidden

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)