Teams

GET

Retrieves information about the authenticated user's team.

get

Responses

200

Team information retrieved successfully

application/json

usersLimitnumberOptionalExample: 5

namestringOptionalExample: Team Name

countnumberOptionalExample: 10

403

Access denied

application/json

404

Team not found

application/json

get

/teams

HTTPcURLJavaScriptPython

GET /teams HTTP/1.1
Accept: */*

{
  "usersLimit": 5,
  "name": "Team Name",
  "count": 10
}

Retrieves members of the authenticated user's team.

get

Responses

200

Team members retrieved successfully

application/json

idnumberOptionalExample: 1

firstNamestringOptionalExample: John

lastNamestringOptionalExample: Doe

phonestringOptionalExample: 123-456-7890

rolestringOptionalExample: Member

isActivebooleanOptionalExample: true

invitationAcceptedbooleanOptionalExample: true

403

Access denied

application/json

get

/teams/members

HTTPcURLJavaScriptPython

GET /teams/members HTTP/1.1
Accept: */*

[
  {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "phone": "123-456-7890",
    "role": "Member",
    "isActive": true,
    "invitationAccepted": true
  }
]

Retrieves available team roles.

get

Responses

200

Team roles retrieved successfully

application/json

labelstringOptionalExample: Member

valuestringOptionalExample: Member

get

/teams/roles

HTTPcURLJavaScriptPython

GET /teams/roles HTTP/1.1
Accept: */*

200

Team roles retrieved successfully

[
  {
    "label": "Member",
    "value": "Member"
  }
]

Checks the team limit for the authenticated user.

get

Responses

200

Team limit checked successfully

application/json

booleanOptionalExample: true

500

Internal server error

application/json

get

/teams/limit

HTTPcURLJavaScriptPython

GET /teams/limit HTTP/1.1
Accept: */*

true

Retrieves all teams based on the provided parameters.

get

Query parameters

offsetnumberOptional

The number of records to skip.

Example: 0

limitnumberOptional

The maximum number of records to return.

Example: 10

globalSearchstringOptional

The global search term to use for finding teams.

Example: Team Name

Responses

200

Teams retrieved successfully

application/json

idstringOptionalExample: team_id

namestringOptionalExample: Team Name

usersLimitnumberOptionalExample: 5

membersCountnumberOptionalExample: 10

subscriptionstringOptionalExample: Basic

isImpersonationEnabledbooleanOptionalExample: true

500

Internal server error

application/json

get

/teams/all

HTTPcURLJavaScriptPython

GET /teams/all HTTP/1.1
Accept: */*

[
  {
    "id": "team_id",
    "name": "Team Name",
    "usersLimit": 5,
    "membersCount": 10,
    "owner": {
      "id": 1,
      "firstName": "John",
      "lastName": "Doe",
      "email": "[e-mail]"
    },
    "subscription": "Basic",
    "isImpersonationEnabled": true
  }
]

POST

Creates a new team.

post

Body

application/json

teamNamestringOptionalExample: Team Name

Responses

201

Team created successfully

application/json

400

Team already exists

application/json

500

Internal server error

application/json

post

/teams

HTTPcURLJavaScriptPython

POST /teams HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "teamName": "Team Name"
}

{
  "id": "team_id",
  "name": "Team Name",
  "usersLimit": 5
}

Creates an invitation to join the team.

post

Body

application/json

emailstringRequiredExample: [e-mail]

firstNamestring · nullableRequiredExample: John

lastNamestring · nullableRequiredExample: Doe

phonestring · nullableRequiredExample: 123-456-7890

rolestring · enumRequiredExample: ViewerPossible values:

teamIdstring · nullableRequiredExample: team_id

Responses

200

Invitation created successfully

application/json

anyOptionalExample: {"message":"Invitation email sent","description":"Wait for the invited person to finish their registration."}

400

Team is full

application/json

403

Access denied

application/json

500

Internal server error

application/json

post

/teams/invitation

HTTPcURLJavaScriptPython

POST /teams/invitation HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "email": "[e-mail]",
  "firstName": "John",
  "lastName": "Doe",
  "phone": "123-456-7890",
  "role": "Viewer",
  "teamId": "team_id"
}

{
  "message": "Invitation email sent",
  "description": "Wait for the invited person to finish their registration."
}

PUT

Leaves a team by its ID. Sends an email to the new owner if provided. Also applies new owners subscription plan to this team.

put

Path parameters

idstringRequired

The ID of the team to leave.

Example: team_id

Body

application/json

newOwnerIdnumberOptionalExample: 1

Responses

200

Left the team successfully

application/json

anyOptionalExample: {"message":"Left the team successfully","description":"You have left the team successfully."}

400

Team not found

application/json

500

Internal server error

application/json

put

/teams/leave-team/{id}

HTTPcURLJavaScriptPython

PUT /teams/leave-team/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "newOwnerId": 1
}

{
  "message": "Left the team successfully",
  "description": "You have left the team successfully."
}

Accepts an invitation to join a team.

put

Path parameters

idstringRequired

The ID of the team to accept the invitation for.

Example: team_id

Responses

200

Invitation accepted successfully

application/json

anyOptionalExample: {"message":"Invitation accepted successfully","description":"You have accepted the invitation successfully."}

400

Membership not found

application/json

500

Internal server error

application/json

put

/teams/accept-invitation/{id}

HTTPcURLJavaScriptPython

PUT /teams/accept-invitation/{id} HTTP/1.1
Accept: */*

{
  "message": "Invitation accepted successfully",
  "description": "You have accepted the invitation successfully."
}

Declines an invitation to join a team.

put

Path parameters

idstringRequired

The ID of the team to decline the invitation for.

Example: team_id

Responses

200

Invitation declined successfully

application/json

anyOptionalExample: {"message":"Invitation declined successfully","description":"You have declined the invitation successfully."}

400

Membership not found

application/json

500

Internal server error

application/json

put

/teams/decline-invitation/{id}

HTTPcURLJavaScriptPython

PUT /teams/decline-invitation/{id} HTTP/1.1
Accept: */*

{
  "message": "Invitation declined successfully",
  "description": "You have declined the invitation successfully."
}

DELETE

Cancels an invitation to join the team.

delete

Path parameters

idnumberRequired

The ID of the user to cancel the invitation for.

Example: 1

Body

application/json

membershipIdnumberOptionalExample: 1

Responses

200

Invitation cancelled successfully

application/json

anyOptionalExample: {"message":"Invitation cancelled successfully","description":"The invitation has been cancelled successfully."}

400

User not found

application/json

500

Internal server error

application/json

delete

/teams/invitation/{id}

HTTPcURLJavaScriptPython

DELETE /teams/invitation/{id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "membershipId": 1
}

{
  "message": "Invitation cancelled successfully",
  "description": "The invitation has been cancelled successfully."
}

Deletes a team by its ID.

delete

Path parameters

idstringRequired

The ID of the team to delete.

Example: team_id

Responses

200

Team deleted successfully

application/json

anyOptionalExample: {"message":"Team deleted successfully","description":"The team has been deleted successfully."}

400

Team not found

application/json

403

Access denied

application/json

500

Internal server error

application/json

delete

/teams/{id}

HTTPcURLJavaScriptPython

DELETE /teams/{id} HTTP/1.1
Accept: */*

{
  "message": "Team deleted successfully",
  "description": "The team has been deleted successfully."
}