---
title: "Request free Yuma access"
method: GET
path: "/agent-access/submit"
---

# Request free Yuma access

`GET /agent-access/submit`

Include at least one non-empty valid query field. After validation, a missing source defaults to yuma.ai and a missing user_agent falls back to the bounded HTTP User-Agent; these defaults never make an empty request operative. The complete URL-encoded query must not exceed 8,192 characters. Empty, unknown, duplicated, oversized, or invalid parameters do not create a request.

## Query parameters

- `email` string, email
- `first_name` string
- `last_name` string
- `company` string
- `website_url` string, uri
- `linkedin_url` string, uri
- `monthly_support_ticket_volume` string
- `ecommerce_platform` string
- `helpdesk_platform` string
- `country_code` string
- `free_note` string
- `source` string
- `user_agent` string

## Response `200`

Storage could not be confirmed. Do not retry automatically or immediately; report the ambiguity and wait for direction.

## Other responses

- `201` — The access request was stored. Save request_id and follow the response.
- `400` — No valid field was supplied; nothing was submitted or stored.
- `403` — Submission is disabled outside the production website.
- `422` — The query was invalid; nothing was submitted or stored.
- `429` — The access-request service is rate limited.

---

[API](https://skmtc.dev/yuma/apis/yuma-ai-agent-access-api.md) · [All operations](https://skmtc.dev/yuma/apis/yuma-ai-agent-access-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yuma/yuma-ai-agent-access-api/revisions/60f3bdb00b4b/schema)
