---
title: "Create Unclaimed Agent"
method: POST
path: "/api/unclaimed/agents"
tags: ["unclaimed"]
---

# Create Unclaimed Agent

`POST /api/unclaimed/agents`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/unclaimed/agents`
- Auth: none declared

Creates one agent in a throwaway account and returns its key and claim URL. No auth.

## Request body

- UnclaimedAgentCreate: The anonymous create request. Exactly one of the three sources is set.
  - `name` string, required
  - `templateId` string, nullable
  - `githubRepo` string, nullable
  - `branch` string, nullable
  - `imageName` string, nullable
  - `initialEnvVars` InitialEnvVar[]
    - `key` string, required
    - `value` string, required
    - `isSecret` boolean
  - `publicWeb` boolean
  - `exposedPort` integer, nullable
  - `client` string, nullable
  - `version` string, nullable

## Response `201`

Successful Response

- UnclaimedAgentCreated: The anonymous create response.
  - `agent` UnclaimedAgentSummary, required: The created agent, as the anonymous caller sees it.
    - `id` string, required
    - `name` string, required
    - `status` string, required
    - `framework` string, required
  - `token` string, required
  - `tokenExpiresAt` string, required
  - `claimUrl` string, required
  - `expiresAt` string, required
  - `limits` UnclaimedLimits, required: The limits of a throwaway account, stated in the response.
    - `machines` integer, required
    - `llmProxy` string, required
    - `ttlHours` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/maritime/apis/maritime-api.md) - [All operations](https://skmtc.dev/maritime/apis/maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maritime/apis/maritime-api/revisions/acd712090ad6?raw)