Skip to main content
Organization APIs are for team administration: listing members, sending invites, updating roles, and managing organization metadata.

​
Organization endpoints

MethodPathDescription
GET/v1/orgsList organizations visible to the token
POST/v1/orgsCreate an organization
GET/v1/orgs/{org_id}Get organization details
PATCH/v1/orgs/{org_id}Update organization metadata
DELETE/v1/orgs/{org_id}Delete an organization

​
Members and invites

MethodPathDescription
GET/v1/orgs/{org_id}/membersList members
PATCH/v1/orgs/{org_id}/members/{target_user_id}Update a member role
DELETE/v1/orgs/{org_id}/members/{target_user_id}Remove a member
POST/v1/orgs/{org_id}/inviteInvite a user
GET/v1/orgs/{org_id}/invitesList pending invites
DELETE/v1/orgs/{org_id}/invites/{invite_id}Revoke an invite
GET/v1/orgs/{org_id}/rolesList available roles

​
Invite a teammate

curl -H "Authorization: Bearer $ARDENT_TOKEN"   -X POST https://api.tryardent.com/v1/orgs/org_123/invite   -H 'Content-Type: application/json'   -d '{"email":"teammate@example.com","role_key":"member"}'

​
Update a role

curl -H "Authorization: Bearer $ARDENT_TOKEN"   -X PATCH https://api.tryardent.com/v1/orgs/org_123/members/user_123   -H 'Content-Type: application/json'   -d '{"role_key":"admin"}'

​
Role guidance

  • Use viewer for read-only users and reporting automation.
  • Use member for developers who create branches and manage day-to-day resources.
  • Use admin for teammates who manage access and shared resources.
  • Reserve owner for organization-level control.