---
title: "Create an agent account, API key, and starter project"
method: POST
path: "/api/auth/agent/register"
---

# Create an agent account, API key, and starter project

`POST /api/auth/agent/register`

## Request

- Base URL: `https://editor.pascal.app`
- URL: `https://editor.pascal.app/api/auth/agent/register`
- Auth: none required

## Request body

- RegisterAgentRequest
  - `name` string, required
  - `purpose` string
  - `agentClient` 'claude-code' | 'chatgpt' | 'cursor' | 'openai-codex' | 'openclaw' | 'windsurf' | 'other'

## Response `201`

Agent account created

- RegisterAgentResponse
  - `userId` string, required: Agent account subject; has no email or browser session.
  - `agentId` string, required: Persistent agent identity; retain across reconnects.
  - `apiKey` string, required
  - `starterProjectId` string, required
  - `sceneApiUrl` string, uri, required
  - `mcpEndpoint` string, uri, required
  - `openApiUrl` string, uri, required
  - `docsUrl` string, uri, required
  - `sandbox` object, required
    - `claimed` false, required
    - `allowed` string[], required
    - `notYetReachableWithAnApiKey` string[], required
    - `blockedUntilClaimed` string[], required
    - `howToClaim` string, required
  - `usage` object, required
    - `setApiKey` string, required
    - `claudeCode` string, required: User-scoped Claude Code setup command. Requires PASCAL_API_KEY to be set first.
    - `listScenes` string, required
    - `getStarterScene` string, required
    - `openApi` string, required
    - `status` string, required
    - `startClaim` string, required
    - `createOrganization` string, required
    - `redeemInvite` string, required
  - `setup` object, required
    - `apiKeyEnvironmentVariable` string, required
    - `claudeCodeCredentialStorage` string, required
    - `shellHistory` string, required
  - `message` string, required

## Other responses

- `400`: Invalid request
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pascal/apis/pascal-editor-scene-api.md) · [All operations](https://skmtc.dev/pascal/apis/pascal-editor-scene-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pascal/apis/pascal-editor-scene-api/revisions/08f1f3f41067?raw)