Organizations API

API for managing organizations in the Ampersand system. Allows creating, editing and managing organizations, as well as managing users within organizations.

Key Features

Creating and managing organizations

Managing users in organizations

Managing roles and access rights

Switching between organizations

Changing organization owner

Organization Structure

Organization - main entity representing a company or group of users

Owner - organization owner with full management rights

Members - users who are members of the organization with various roles

Teams - teams within the organization for grouping users

User Roles

Owner - organization owner with full rights

Admin - administrator with user management rights

Member - regular organization member

Authorization

All requests to the Organizations 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 perform operations

Base URL


https://auth.ampersand-it.com/api/organizations

Usage Example

Getting all user organizations:


curl -X GET "https://auth.ampersand-it.com/api/organizations" \
  -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 - Organization not found

400 Bad Request - Invalid request parameters