Organizations - Tierity Docs

Endpoints

Method	Path	Role needed	Description
`GET`	`/api/organizations`	Any	Organizations you belong to
`GET`	`/api/organizations/{orgId}`	Viewer	One organization
`PATCH`	`/api/organizations/{orgId}`	Admin	Update name, logo and other settings
`GET`	`/api/organizations/{orgId}/members`	Viewer	List members
`PATCH`	`/api/organizations/{orgId}/members/{userId}/role`	Admin	Change a member’s role
`DELETE`	`/api/organizations/{orgId}/members/{userId}`	Admin	Remove a member
`GET`	`/api/organizations/{orgId}/invitations`	Admin	Pending invitations
`POST`	`/api/organizations/{orgId}/invitations`	Admin	Invite someone by email
`POST`	`/api/organizations/{orgId}/invitations/{invitationId}/resend`	Admin	Resend an invitation
`DELETE`	`/api/organizations/{orgId}/invitations/{invitationId}`	Admin	Cancel an invitation
`GET`	`/api/organizations/{orgId}/team-limits`	Member	Seats used and available on your plan

List your organizations

curl https://tierity.com/api/organizations \
  -H "Authorization: Bearer pk_..."

Each organization includes its id, name, plan, logo, and memberCount and pendingInviteCount.

List members

curl https://tierity.com/api/organizations/{orgId}/members \
  -H "Authorization: Bearer pk_..."

[
  {
    "id": "8f0c…",
    "user_id": "8f0c…",
    "role": "admin",
    "joined_at": "2026-09-14T18:20:00.000Z",
    "email": "sam@example.com",
    "first_name": "Sam",
    "last_name": "Rivera",
    "avatar_url": null
  }
]

Change a member’s role

curl -X PATCH https://tierity.com/api/organizations/{orgId}/members/{userId}/role \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{"role": "manage"}'

role is one of viewer, member, manage, admin or org_owner. See Roles and permissions.

Invite someone

curl -X POST https://tierity.com/api/organizations/{orgId}/invitations \
  -H "Authorization: Bearer pk_..." \
  -H "Content-Type: application/json" \
  -d '{"email": "alex@example.com", "role": "member"}'

role defaults to member. The invitation email is sent straight away and expires after 7 days. If your plan has no seats left, the response is 402 with "reason": "seat_limit".

Remove a member

curl -X DELETE https://tierity.com/api/organizations/{orgId}/members/{userId} \
  -H "Authorization: Bearer pk_..."

The member loses access immediately.