User APIs
users

Add User

Changed on
post/api/v1/users/self/add-user

Request

  • Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
  • URL: https://carbonarc.ai/api/v1/users/self/add-user
  • Auth: OAuth 2 (authorization code, authorization URL authorize, token URL token)

Request body

emailstring email required
first_namestring required
last_namestring required
extra_profile_dataobject nullable
role_idstring uuid4 nullable
block_role'block_user' | 'block_admin'

Additive Block role values stored directly on users.block_role and groups.block_role (block_role_enum Postgres enum). Matches the snake_case value set used elsewhere in the Block domain.

distributor_role'Distributor Admin' | 'Distributor User'

Additive distributor role stored directly on users.distributor_role (distributor_role_enum Postgres enum), the same pattern as block_role. DISTRIBUTOR_ADMIN grants access to the platform's distributor features, scoped by the user's client's distributor contract(s); DISTRIBUTOR_USER marks a non-administrative distributor user and grants no distributor-view access on its own.

transaction_limitnumber nullable
allocated_amountnumber nullable
mcp_daily_limitnumber nullable
group_idstring uuid4 nullable

Response

Successful Response

unknown required

Changes