Teams API
API for managing teams within organizations. Allows creating teams, managing team members and their roles.
Key Features
Creating and managing teams in organizations
Adding and removing team members
Managing team member roles
Changing team owner
Getting organization teams list
Team Structure
Team - team within an organization
Owner - team owner with full management rights
Members - team members with various roles
Organization - organization to which the team belongs
Team Member Roles
Owner - team owner with full rights
Admin - team administrator
Member - regular team member
Authorization
All requests to the Teams API require authorization using a JWT token.
The token must be passed in the Authorization header: Bearer {token}
The user must have access to the organization to manage teams
Base URL
https://auth.ampersand-it.com/api/teams
Usage Example
Getting all organization teams:
curl -X GET "https://auth.ampersand-it.com/api/teams/organization/{organizationId}" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Error Handling
401 Unauthorized - Invalid or missing authorization token
403 Forbidden - Insufficient rights to perform the operation
404 Not Found - Team not found
400 Bad Request - Invalid request parameters
Relationship with Organizations
Teams always belong to a specific organization
To create a team, you must specify the organization ID
Users can be team members only if they have access to the organization