Developer
API REFERENCE

Account & organisation API

35 REST endpoints for account & organisation, each with its parameters, the response it returns and a runnable curl example. Starts with POST…

POST/api/billing/cancel

Cancel / downgrade

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/billing/checkout

Checkout

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 4
NameInDescription
periodbodyJSON request field
planbodyJSON request field
couponbodyJSON request field
gatewaybodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/billing/coupon/check

Create or update billing coupon check

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 3
NameInDescription
periodbodyJSON request field
planbodyJSON request field
codebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/billing/gst-report

GST report for Indian accounting

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/billing/invoice/{id}

Invoice (HTML, printable to PDF from the browser)

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/billing/pricing

Pricing info (used by the pricing page and the upgrade modal)

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/billing/resume

Create or update billing resume

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/billing/subscription

Get billing subscription

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/billing/trial

A paid-plan trial is a real, time-bounded entitlement. It can be used once per organisation and needs no gateway round trip; attachContext returns the workspace to Free as soon as the end date is reached.

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
planbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/me

Session / bootstrap info for the SPA

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/metadata

Page metadata fetch (used by the create dialog to auto-fill titles)

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
urlbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/org

=================================================================== ORGANIZATION ===================================================================

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org

Create or update org

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
s3EnabledbodyJSON request field
billingCountrybodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org/create

Create or update org create

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
namebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/org/detect

Get org detect

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
DELETE/api/org/invites/{id}

Delete org invites by ID

Open interactive reference →

Removes the selected resource after authorization. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org/invites/{id}/resend

Create or update org invites by ID resend

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
DELETE/api/org/members/{id}

Delete org members by ID

Open interactive reference →

Removes the selected resource after authorization. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org/members/{id}/role

Create or update org members by ID role

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
idpathRequired path parameter
rolebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org/members/invite

Create or update org members invite

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 3
NameInDescription
emailbodyJSON request field
rolebodyJSON request field
teamIdbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/org/switch

Create or update org switch

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
orgIdbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
DELETE/api/profile

Delete profile

Open interactive reference →

Removes the selected resource after authorization. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
passwordbodyJSON request field
confirmbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/profile

=================================================================== PROFILE (5 tabs) ===================================================================

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/profile/avatar

Create or update profile avatar

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/profile/email

Create or update profile email

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
emailbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/profile/export

GDPR data export

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/profile/phone/send-otp

Create or update profile phone send otp

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
phonebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/profile/phone/verify

Create or update profile phone verify

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
codebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
GET/api/teams

=================================================================== TEAMS ===================================================================

Open interactive reference →

Returns data without changing the resource. Access is limited by the API key scope and the workspace plan.

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/teams

Create or update teams

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
namebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
DELETE/api/teams/{id}

Delete teams by ID

Open interactive reference →

Removes the selected resource after authorization. Access is limited by the API key scope and the workspace plan.

Parameters 1
NameInDescription
idpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/teams/{id}

Create or update teams by ID

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 5
NameInDescription
idpathRequired path parameter
namebodyJSON request field
enforce2fabodyJSON request field
ownerIdbodyJSON request field
samlbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/teams/{id}/domains

Create or update teams by ID domains

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 3
NameInDescription
idpathRequired path parameter
domainIdbodyJSON request field
attachbodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
POST/api/teams/{id}/members

Create or update teams by ID members

Open interactive reference →

Validates the payload and returns the resulting resource. Access is limited by the API key scope and the workspace plan.

Parameters 3
NameInDescription
idpathRequired path parameter
emailbodyJSON request field
rolebodyJSON request field

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited
DELETE/api/teams/{id}/members/{userId}

Delete teams by ID members :userId

Open interactive reference →

Removes the selected resource after authorization. Access is limited by the API key scope and the workspace plan.

Parameters 2
NameInDescription
idpathRequired path parameter
userIdpathRequired path parameter

Examples in 22 languages and Try it →

Responses
200 Success400 Invalid request401 Invalid key429 Rate limited