Team API

Team API Your team is everyone who works inside your account besides you — admins, agents and read-only viewers — plus the invitations you have sent and the departments you organise them into. The Team API is the programmatic version of Settings → Team : add and remove people, set what each of them can see and do, send and chase invitations, and manage departments. All endpoints below are relative to the base URL https://api.relaytiv.com/v1 . For the dashboard version of everything on this page, see Team Management . Authentication: these endpoints need a signed-in person This is the one part of the API that an API key cannot use. Every /team endpoint except the department ones has to be called with a Firebase ID token from a signed-in session: Authorization: Bearer <Firebase ID token> Send an API key instead and the request is rejected with a 401 : { "success": false, "error_code": 401, "error": "This endpoint requires a Firebase ID token (Authorization: Bearer <token>)." } The reason is that these endpoints decide what to do based on who is signed in : your role, the ceiling on what you are allowed to grant someone else, and whether you are currently working inside another account. An API key is an integration, not a person, so there is nobody for those rules to apply to. In practice that means the Team API is for a first-party app with a logged-in Relaytiv user (see Authentication → Firebase ID token ). A server-to-server integration cannot manage team members