---
title: "Create a temporary guest token"
method: POST
path: "/api/v1/guest/token"
tags: ["Guest Onboarding"]
---

# Create a temporary guest token

`POST /api/v1/guest/token`

## Request

- Base URL: `https://workers.miniurl.com`
- URL: `https://workers.miniurl.com/api/v1/guest/token`
- Auth: none required

## Response `200`

Guest token created

- GuestTokenResponse
  - `success` boolean, required
  - `data` object, required
    - `guest_token` string, required
    - `expires_at` string, date-time, required
    - `limits` object, required
      - `max_links` integer, required
      - `max_requests` integer, required
      - `expires_in_seconds` integer, required
  - `meta` Meta
    - `account_type` string
    - `hint` string
    - `usage` object
    - `notices` object[]
    - `limitations` string[]
    - `upgrade` object

## Other responses

- `429`: Rate limit, token quota, or plan quota exceeded

---

[API](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api.md) · [All operations](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miniurl/apis/miniurl-agent-first-api/revisions/1d12196927db?raw)