Organizations API

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

Organization endpoints

Method	Path	Description
`GET`	`/v1/orgs`	List organizations — dashboard session only
`POST`	`/v1/orgs`	Create an organization — dashboard session only
`GET`	`/v1/orgs/{org_id}`	Get organization details
`PATCH`	`/v1/orgs/{org_id}`	Update organization metadata
`DELETE`	`/v1/orgs/{org_id}`	Delete an organization

GET /v1/orgs and POST /v1/orgs accept only a logged-in dashboard session, not API tokens — an sk-ard_ token gets 401. API tokens belong to one organization, so they don’t need to list or create orgs. Every other endpoint on this page accepts API tokens.

Members and invites

Method	Path	Description
`GET`	`/v1/orgs/{org_id}/members`	List 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}/invite`	Invite a user
`GET`	`/v1/orgs/{org_id}/invites`	List pending invites
`DELETE`	`/v1/orgs/{org_id}/invites/{invite_id}`	Revoke an invite
`GET`	`/v1/orgs/{org_id}/roles`	List 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.

An organization’s last owner can’t be demoted or removed — promote someone else first.

Start here

Core resources

Administration

Organizations API

Organization endpoints

Members and invites

Invite a teammate

Update a role

Role guidance

​Organization endpoints

​Members and invites

​Invite a teammate

​Update a role

​Role guidance

Organization endpoints

Members and invites

Invite a teammate

Update a role

Role guidance