Source: equa-server/modules/api/src/endpoints/organization-endpoints.ts

Organization Endpoints

Endpoints for creating and managing organizations, members, roles, addresses, emails, branches, authorizations, and tasks. All organization endpoints require authentication. Most require specific RBAC permissions scoped to the organization.

Organizations

Create Organization

POST /v1/organization

Field	Value
Auth	Required

Create a new organization. The authenticated user becomes the owner. Request:

{
  "name": "Acme Inc.",
  "type": "corporation"
}

List User Organizations

GET /v1/organization

Field	Value
Auth	Required

List all organizations the authenticated user belongs to.

Get Organization

GET /v1/organization/:organization

Field	Value
Auth	Required
Permission	`canViewOrganization`

Get details for a specific organization.

Update Organization

PATCH /v1/organization/:organization

Field	Value
Auth	Required
Permission	`canEditOrganization`

Update organization settings.

Get Organization Dashboard

GET /v1/organization/:organization/dashboard

Field	Value
Auth	Required
Permission	`canViewOrganization`

Get summary statistics for the organization dashboard.

Get User Permissions

GET /v1/organization/:organization/user/:user

Field	Value
Auth	Required

Get the permissions a specific user has within an organization.

Members

List Members

GET /v1/organization/:organization/member

Field	Value
Auth	Required
Permission	`canViewSomeMembers`

List all members of an organization.

Get Member

GET /v1/organization/:organization/member/:member

Field	Value
Auth	Required
Permission	`canViewMember`

Get details for a specific member.

Add Member

POST /v1/organization/:organization/member

Field	Value
Auth	Required
Permission	`canEditMembers`

Add a new member to the organization.

Invite Members

POST /v1/organization/:organization/member/invite

Field	Value
Auth	Required
Permission	`canEditMembers`

Send email invitations to one or more people to join the organization. Request:

{
  "emails": ["alice@example.com", "bob@example.com"]
}

Update Member

PATCH /v1/organization/:organization/member/:member

Field	Value
Auth	Required
Permission	`canEditOrganization`

Update a member’s details or role.

Remove Member

DELETE /v1/organization/:organization/member/:member

Field	Value
Auth	Required
Permission	`canEditOrganization`

Remove a member from the organization by member ID.

Remove Member by User

DELETE /v1/organization/:organization/user/:user

Field	Value
Auth	Required
Permission	`canEditOrganization`

Remove a member from the organization by user ID.

Get Member Limit

GET /v1/organization/:organization/structure/member/limit

Field	Value
Auth	Required
Permission	`canViewMembers`

Get the member limit for the organization based on the current subscription plan.

Get Entity Members

GET /v1/entity/:entity/member

Field	Value
Auth	Required

Get members associated with a specific entity.

Roles

Create Role

POST /v1/organization/:organization/role

Field	Value
Auth	Required
Permission	`canEditMembers`

List Roles

GET /v1/organization/:organization/role

Field	Value
Auth	Required
Permission	`canViewMembers`

Get Role

GET /v1/organization/:organization/role/:role

Field	Value
Auth	Required
Permission	`canViewMembers`

Update Role

PUT /v1/organization/:organization/role/:role

Field	Value
Auth	Required
Permission	`canEditMembers`

Delete Role

DELETE /v1/organization/:organization/role/:role

Field	Value
Auth	Required
Permission	`canEditMembers`

Assign Role to Member

PUT /v1/organization/:organization/role/:role/member

Field	Value
Auth	Required
Permission	`canEditMembers`

Authorizations

List Authorizations

GET /v1/authorization

Field	Value
Auth	Required

Create Authorization

POST /v1/organization/:organization/authorization

Field	Value
Auth	Required

Delete Authorization

DELETE /v1/organization/:organization/authorization/:authorization

Field	Value
Auth	Required
Permission	`canEditCapTable`

Branches

Create/Update Branch

PUT /v1/organization/:organization/branch/:branch

Field	Value
Auth	Required
Permission	`canEditCapTable`

Get Branch

GET /v1/organization/:organization/branch/:branch

Field	Value
Auth	Required
Permission	`canViewOrganization`

List Branches

GET /v1/organization/:organization/branch

Field	Value
Auth	Required
Permission	`canViewOrganization`

Addresses

Create Address

POST /v1/entity/:entity/address

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Update Address

PUT /v1/entity/:entity/address/:address

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Delete Address

DELETE /v1/entity/:entity/address/:address

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

List Addresses

GET /v1/entity/:entity/address

Field	Value
Auth	Required
Permission	`canViewEntityAddress`

Get Address

GET /v1/entity/:entity/address/:address

Field	Value
Auth	Required
Permission	`canViewEntityAddress`

Emails

Create Email

POST /v1/entity/:entity/email

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Also syncs billing email addresses with Chargify.

Update Email

PUT /v1/entity/:entity/email/:email

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Delete Email

DELETE /v1/entity/:entity/email/:email

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Batch Create Emails

POST /v1/entity/:entity/email/many

Field	Value
Auth	Required
Permission	`canEditEntityAddress`

Create multiple email records in a single request.

List Emails

GET /v1/entity/:entity/email

Field	Value
Auth	Required
Permission	`canViewEntityAddress`

Get Email

GET /v1/entity/:entity/email/:email

Field	Value
Auth	Required
Permission	`canViewEntityAddress`

Tasks

Update Task

PUT /v1/entity/:entity/task/:type

Field	Value
Auth	Required

Get Tasks

GET /v1/entity/:entity/task

Field	Value
Auth	Required

Files

Upload Organization Document

POST /v1/organization/:organization/file

Field	Value
Auth	Required
Permission	`canEditDocuments`

Upload a file to the organization. Uses multipart/form-data. Max file size is configurable via AWS_S3_UPLOAD_SIZE_LIMIT_MB (default 10 MB).

Download File

GET /v1/file/:file/content

Field	Value
Auth	Required
Permission	`canViewFile`

Download a file as an attachment.

View File Inline

GET /v1/file/:file/content/:name

Field	Value
Auth	Required
Permission	`canViewFile`

View a file inline in the browser (Content-Disposition: inline).

Support

Contact Support

POST /v1/support/contact

Field	Value
Auth	Required

Send a support email from the authenticated user.

​Organization Endpoints

​Organizations

​Create Organization

​List User Organizations

​Get Organization

​Update Organization

​Get Organization Dashboard

​Get User Permissions

​Members

​List Members

​Get Member

​Add Member

​Invite Members

​Update Member

​Remove Member

​Remove Member by User

​Get Member Limit

​Get Entity Members

​Roles

​Create Role

​List Roles

​Get Role

​Update Role

​Delete Role

​Assign Role to Member

​Authorizations

​List Authorizations

​Create Authorization

​Delete Authorization

​Branches

​Create/Update Branch

​Get Branch

​List Branches

​Addresses

​Create Address

​Update Address

​Delete Address

​List Addresses

​Get Address

​Emails

​Create Email

​Update Email

​Delete Email

​Batch Create Emails

​List Emails

​Get Email

​Tasks

​Update Task

​Get Tasks

​Files

​Upload Organization Document

​Download File

​View File Inline

​Support

​Contact Support