---
title: "Create Guest"
method: POST
path: "/api/v1/auth/guest"
tags: ["auth", "web_app"]
---

# Create Guest

`POST /api/v1/auth/guest`

创建游客账号

## Request body

- GuestRequest — 游客请求
  - `device_id` string, nullable
  - `system_language` string, nullable
  - `age_group` string, nullable
  - `request_id` string, nullable

## Response `200`

Successful Response

- APIResponseGuestResponse
  - `code` integer
  - `message` string
  - `data` GuestResponse — 游客响应
    - `guest_id` string, required
    - `token` string, required
    - `is_new_guest` boolean, required

## Other responses

- `422` — Validation Error

## Changes

- **2025-11-25** `05cf5f034c74` — 1 info
  - api tag `web_app` added
- **2025-09-29** `bd9470194fe1` — 1 info
  - added the new optional request property `request_id`

[Change history](https://skmtc.dev/nascentcore/apis/inty-backend/changes/api/v1/auth/guest/post.md)

---

[API](https://skmtc.dev/nascentcore/apis/inty-backend.md) · [All operations](https://skmtc.dev/nascentcore/apis/inty-backend/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nascentcore/inty-backend/revisions/1e014c365df2/schema)
