> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> Read organizations, list and manage members, and send invitations.

## 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

```bash theme={null}
curl https://tierity.com/api/organizations \
  -H "Authorization: Bearer pk_..."
```

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

## List members

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

```json theme={null}
[
  {
    "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

```bash theme={null}
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](https://docs.tierity.com/concepts/roles-permissions.md).

## Invite someone

```bash theme={null}
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

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

The member loses access immediately.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.