---
title: "Create account graph"
method: POST
path: "/admin/accounts/"
tags: ["Admin"]
---

# Create account graph

`POST /admin/accounts/`

## Request body

- AdminAccountsCreateDTO
  - `options` AdminAccountCreateOptionsDTO
    - `dry_run` boolean, nullable
    - `idempotency_key` string, nullable
    - `create_identities` boolean, nullable
    - `create_api_keys` boolean, nullable
    - `return_api_keys` boolean, nullable
    - `seed_defaults` boolean, nullable
    - `reason` string, nullable
  - `users` object, nullable
  - `user_identities` object, nullable
  - `organizations` object, nullable
  - `workspaces` object, nullable
  - `projects` object, nullable
  - `organization_memberships` object, nullable
  - `workspace_memberships` object, nullable
  - `project_memberships` object, nullable
  - `api_keys` object, nullable
  - `subscriptions` object, nullable

## Response `200`

Successful Response

- AdminAccountsResponseDTO — Response for the full graph endpoint (POST /accounts/).
  - `accounts` AdminAccountReadDTO[]
    - `users` object
    - `user_identities` object
    - `organizations` object
    - `workspaces` object
    - `projects` object
    - `organization_memberships` object
    - `workspace_memberships` object
    - `project_memberships` object
    - `subscriptions` object, nullable
    - `api_keys` object, nullable
  - `errors` AdminStructuredErrorDTO[], nullable
    - `code` string, required
    - `message` string, required
    - `details` object, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-05-07** `dc41a70e3ad8` — 1 breaking
  - api path removed without deprecation
- **2026-04-16** `8b06b786c977` — 5 breaking, 2 info
  - removed the enum value `admin` of the request property `organization_memberships/additionalProperties/role`
  - removed the enum value `annotator` of the request property `organization_memberships/additionalProperties/role`
  - removed the enum value `developer` of the request property `organization_memberships/additionalProperties/role`
  - removed the enum value `editor` of the request property `organization_memberships/additionalProperties/role`
  - …3 more
- **2026-04-01** `6d5b448e6a4f` — 9 breaking, 3 warning, 12 info
  - removed the enum value `deployment_manager` of the request property `organization_memberships/additionalProperties/role`
  - removed the enum value `deployment_manager` of the request property `project_memberships/additionalProperties/role`
  - removed the enum value `deployment_manager` of the request property `workspace_memberships/additionalProperties/role`
  - removed the enum value `evaluator` of the request property `organization_memberships/additionalProperties/role`
  - …20 more
- …earlier changes not shown

[Full history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/admin/accounts/post.md)

---

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