---
title: "Ensure Dock has an account that AI Studio created"
method: POST
path: "/api/svc-registry/accounts"
tags: ["svc-registry"]
---

# Ensure Dock has an account that AI Studio created

`POST /api/svc-registry/accounts`

## Request

- Base URL: `https://app.gocrisp.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.gocrisp.com/api/svc-registry/accounts`
- Auth: none declared

Create the account's catalog row and platform parent edge unless Dock already has it.

Idempotent and runtime-only: the Studio route that calls this is already restricted to
platform admins, and a forwarded user credential is refused. An existing account is left
unchanged (an earlier create whose FGA sync failed is finished), and a deleted one is never
revived. A 502 means the platform parent edge or the global installs are not in place yet:
call again. New accounts use the legacy segment, the same as accounts synced from the core
platform, and take the Studio id as their number.

## Request body

- EnsureStudioAccountRequest: A numeric AI Studio account id and its display name.
  - `id` string, required: The Studio account id, also Dock's account id.
  - `name` string, required

## Response `200`

Successful response, including any rejected FGA tuple operations.

- EnsureStudioAccountResponseWithFgaWriteReport
  - `id` string, required
  - `created` boolean, required: False when Dock already had the account and nothing changed.
  - `rejectedTuples` RejectedTuple[]: Tuple operations rejected by Auth0 FGA during this request.
    - `operation` 'write' | 'delete', required
    - `tuple` RejectedTupleKey, required: Public tuple identity for a rejected write operation.
      - `user` string, required
      - `relation` string, required
      - `object` string, required
    - `reason` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `28c7a7fa47be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gocrisp/apis/crisp-app-dock/changes/api/svc-registry/accounts/post.md)

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) - [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) - [OpenAPI document](https://skmtc.dev/gocrisp/apis/crisp-app-dock/revisions/28638f87e7d4?raw)
