---
title: "Start a public guest agent session"
method: POST
path: "/sessions"
tags: ["Guest access"]
---

# Start a public guest agent session

`POST /sessions`

## Request

- Base URL: `https://aiurion.com/api/agent/v1`
- URL: `https://aiurion.com/api/agent/v1/sessions`
- Auth: none required

Immediately returns a scoped 24-hour Bearer token with three free quote attempts. No account, invitation, or payment method is required. Network-level issuance limits prevent repeatedly creating sessions to bypass the allowance.

## Headers

- `X-Agent-Name` string

## Request body

- object
  - `agentName` string: Send the actual host platform: ChatGPT, Cursor, Grok Bot, Grok, Claude, Codex, or your application name. Do not send the task, persona or model name. Use unknown if unavailable. Retained for quote and paid-order source attribution.

## Response `201`

Guest session created

- object
  - `success` true, required
  - `requestId` string, uuid, required
  - `session` object, required
    - `accessToken` string, required: Short-lived secret returned once. Send it in the Authorization Bearer header.
    - `tokenType` 'Bearer', required
    - `accessTier` 'guest', required
    - `expiresAt` string, date-time, required
    - `quoteAllowance` integer, required
    - `rateLimitPerMinute` integer, required
    - `scopes` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing, invalid, inactive, or expired token
- `403`: The credential lacks the required scope
- `404`: Resource not found
- `409`: Request conflict
- `413`: Uploaded request is too large
- `415`: Unsupported request content type
- `429`: Rate or beta quota exceeded
- `500`: Unexpected server error
- `503`: Agent API temporarily unavailable

---

[API](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api.md) · [All operations](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiurion/apis/aiurion-agentic-3d-printing-api/revisions/949ce997a10c?raw)