---
title: "Admin API Authentication"
method: POST
path: "/admin/token"
tags: ["API Keys"]
---

# Admin API Authentication

`POST /admin/token`

Authenticate against the Admin API.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Request body

- CreateAdminTokenRequest
  - `username` string, required — Username or email of the Developer Dashboard user used to create an Admin API token.
  - `password` string, required — Password of the Developer Dashboard user used to create an Admin API token.

## Response `200`

OK

- object
  - `data` CreateAdminTokenResponseData, required
    - `token` string, uuid, required — Short-lived token that is used to authorize Admin API endpoints.
    - `expiration` string, date-time, required — Timestamp of when the Admin API token expires.
    - `workspace_name` string, required — Name of the workspace the Admin API token is authorized for.
    - `mode` 'sandbox' | 'development' | 'production', required — The mode that the Admin API token is authorized for.
    - `user_role` 'owner' | 'administrator' | 'developer', required — The role of the developer-dashboard user the Admin API token was authenticated with.

---

[API](https://skmtc.net/getpinwheel/apis/pinwheel.md) · [All operations](https://skmtc.net/getpinwheel/apis/pinwheel/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpinwheel/pinwheel/revisions/8ef86dd4902e/schema)