---
title: "Create a workspace owned by the authenticated agent"
method: POST
path: "/api/auth/agent/organizations"
---

# Create a workspace owned by the authenticated agent

`POST /api/auth/agent/organizations`

## Request

- Base URL: `https://editor.pascal.app`
- URL: `https://editor.pascal.app/api/auth/agent/organizations`
- Auth: HTTP bearer

Creates an ordinary Pascal workspace and an owner membership for the agent account identified by the Bearer API key. Unclaimed autonomous agents may use this route.

## Request body

- CreateAgentOrganizationRequest
  - `name` string, required
  - `slug` string: Optional lowercase URL slug. If omitted, Pascal derives one from the name and retries collisions with a suffix.

## Response `201`

Workspace created; the agent is its owner

- CreateAgentOrganizationResponse
  - `organization` AgentOrganization, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
  - `role` 'owner', required
  - `next` object, required
  - `message` string, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key/session
- `403`: Authenticated credential is not permitted to perform this operation
- `409`: No unique workspace slug could be allocated

---

[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)