Organisations and members

Create orgs, invite teammates, set roles.

Every action in DomainGenius runs in the context of an organisation. Domains, contacts, balance, and audit logs all live on the org, not the user.

Solo accounts

Sign-up creates a default org for you. You can stay there forever — no penalty for never adding members. The org’s slug and name become editable once you decide.

Multi-tenant accounts

Add an org per client, project, or business unit. Each org has its own balance, billing, and domain list. Users move between orgs from the dashboard switcher.

Create an org

bash

curl -X POST "https://api.domaingenius.com.au/api/v1/orgs" \
  -H "Authorization: Bearer $DG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme", "slug": "acme" }'

The slug must be unique across the platform. Check first with GET /v1/orgs/check-slug?slug=acme.

Invite a member

bash

curl -X POST "https://api.domaingenius.com.au/api/v1/orgs/$DG_ORG/members" \
  -H "Authorization: Bearer $DG_KEY" \
  -d '{ "email": "teammate@example.com", "role": "admin" }'

The invitee gets an email with a sign-in link. If they don’t have a DomainGenius account, the same flow signs them up. Pending invites expire in 7 days.

Roles

Role	Can do
`owner`	Everything. There must be at least one owner.
`admin`	Everything except deleting the org or transferring ownership.
`member`	Read everything; trigger no state changes. Useful for read-only audit accounts.

Change a role with PATCH /v1/orgs/{org_oid}/members/{user_oid}.

Transfer ownership

Owner-only. From the dashboard: /dashboard/settings/danger-zone. The new owner gets an acceptance email; until they accept, both of you are owners.

Delete an org

Owner-only, requires zero registered domains. Move or delete domains first. Deleting refunds any unspent balance to the original payment method.

Last updated just now Edit this page