Skip to content
Upwarden Docs

POST /api/v1/admin/orgs/:slug/domains

This page is auto-generated from src/admin/routes.ts. Do not edit by hand — see docs/dev/docs-auto-sync.md.

:warning: Heuristic extraction — not a contract. Response shapes below are mined from c.json(...) literals in the handler via an AST walker. Computed fields, ternaries, and non-literal returns are shown as placeholders. Refer to the linked source file for the authoritative behaviour.

POST /api/v1/admin/orgs/:slug/domains

Section titled “POST /api/v1/admin/orgs/:slug/domains”

Authentication

Section titled “Authentication”

Requires the following capability(ies):

  • members:w

Middleware

Section titled “Middleware”

Other middleware observed on this route (heuristic):

  • requireCapability
  • adminDomainClaimBody

Responses

Section titled “Responses”

HTTP 404

Section titled “HTTP 404”
{
  "error": "Org not found"
}

HTTP 400

Section titled “HTTP 400”
{
  "error": "Invalid JSON body"
}

HTTP 400

Section titled “HTTP 400”
{
  "error": "Body must be a JSON object"
}

HTTP 400

Section titled “HTTP 400”
{
  "error": <member-expr>
}

HTTP 400

Section titled “HTTP 400”
{
  "error": "default_role must be one of: admin, member, viewer"
}

HTTP 409

Section titled “HTTP 409”
{
  "error": <ternary>,
  "claim_id": <member-expr>
}

HTTP 201

Section titled “HTTP 201”
{
  "claim_id": <member-expr>,
  "domain": <domain>,
  "default_role": <defaultRole>,
  "verification_method": "dns_txt",
  "verification": {
    "record_host": <call>,
    "record_type": "TXT",
    "record_value": <call>,
    "instructions": <expr>
  },
  "verified": false
}

Source

Section titled “Source”
  • File: src/admin/routes.ts
  • Line: 828