How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Sageox Teams API

Create and manage teams with hierarchical membership (owner, admin, member). Handles invitations via email with role assignment, team-wide conventions and norms, and child-team relationships. Teams are the primary organizational unit in SageOx.

Sageox Teams API is one of 23 APIs that Sageox publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Team. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 35 operations across 25 paths, and defines 1 schema. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 3 base URLs: http://localhost:3000, https://test.sageox.ai, https://sageox.ai.

35 operations 25 paths 1 schemas 6 DELETE14 GET10 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Servers
http://localhost:3000
https://test.sageox.ai
https://sageox.ai
Authentication
HTTP Bearer
Contact
SageOx Team
License
MIT
Resource Areas
1

Authentication & Security 1

Sageox Teams API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — JWT token obtained from the auth service (/api/auth/token). Token is validated using JWKS from the auth service. Required claims: sub (userid), email, name, ti…

Paths & Operations 35

Across 25 paths, the API surfaces 35 operations — 6 DELETE, 14 GET, 10 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Teams 35

Create and manage teams with hierarchical membership (owner, admin, member). Handles invitations via email with role assignment, team-wide conventions and norms, and child-team re…

POST
/api/v1/teams
Create a new team
createTeam body → 201400401500
GET
/api/v1/teams
List user's teams
listTeams 2 params → 200401500
GET
/api/v1/teams/{team_id}
Get team details
getTeam 1 param → 200400401403404500
PUT
/api/v1/teams/{team_id}
Update team details
updateTeam 1 param body → 200400401403404500
DELETE
/api/v1/teams/{team_id}
Delete a team
deleteTeam 1 param → 204400401403404500
GET
/api/v1/teams/check-slug
Check if team slug is available
checkTeamSlug 1 param → 200400
POST
/api/v1/teams/{team_id}/adoptdeprecated
Team adoption (deprecated)
adoptTeam 1 param → 410
POST
/api/v1/teams/claim
Claim team ownership with code
claimTeam body → 200400401404410
GET
/api/v1/teams/{team_id}/parent
Get team's parent
getTeamParent 1 param → 200401403404
PUT
/api/v1/teams/{team_id}/parent
Set or unset team parent
setTeamParent 1 param body → 200400401403404
GET
/api/v1/teams/{team_id}/children
Get team's child teams
getTeamChildren 1 param → 200401403404
GET
/api/v1/teams/{team_id}/ancestors
Get team's ancestor chain
getTeamAncestors 1 param → 200401403404
GET
/api/v1/teams/{team_id}/members
List team members
listTeamMembers 1 param → 200401403404
PUT
/api/v1/teams/{team_id}/members/{user_id}
Update team member role
updateTeamMemberRole 2 params body → 200400401403404
DELETE
/api/v1/teams/{team_id}/members/{user_id}
Remove team member
removeTeamMember 2 params → 204400401403404
DELETE
/api/v1/teams/{team_id}/members/me
Leave team
leaveTeam 1 param → 204400401404
PUT
/api/v1/teams/{team_id}/members/bulk
Bulk update member roles
bulkUpdateTeamMemberRoles 1 param body → 200400401403
DELETE
/api/v1/teams/{team_id}/members/bulk
Bulk remove members
bulkRemoveTeamMembers 1 param body → 200400401403
POST
/api/v1/teams/{team_id}/invites
Create team invite
createTeamInvite 1 param body → 201400401403404409
GET
/api/v1/teams/{team_id}/invites
List pending team invites
listTeamInvites 1 param → 200401403404
DELETE
/api/v1/teams/{team_id}/invites/{invite_id}
Revoke team invite
revokeTeamInvite 2 params → 204401403404
GET
/api/v1/invites/team/{token}
Get team invite details
getTeamInviteByToken 1 param → 200404410
GET
/api/v1/teams/{team_id}/invite-code
Get team invite code
getTeamInviteCode 1 param → 200401403404
POST
/api/v1/teams/{team_id}/invite-code
Regenerate team invite code
regenerateTeamInviteCode 1 param → 200401403404
POST
/api/v1/teams/{team_id}/join
Join team with invite code
joinTeamWithCode 1 param body → 200400401404
POST
/api/v1/teams/{team_id}/delete
Initiate team deletion
initiateTeamDeletion 1 param body → 200401403404
GET
/api/v1/teams/{team_id}/delete
Get team deletion status
getTeamDeletionStatus 1 param → 200401404
POST
/api/v1/teams/{team_id}/delete/confirm
Confirm team deletion
confirmTeamDeletion 1 param body → 200400401403404
POST
/api/v1/teams/{team_id}/delete/cancel
Cancel team deletion
cancelTeamDeletion 1 param → 200400401403404
GET
/api/v1/teams/{team_id}/conventions
Get team conventions
getTeamConventions 1 param → 200401403404
PUT
/api/v1/teams/{team_id}/conventions/draft
Save draft conventions
saveDraftConventions 1 param body → 200401403404
DELETE
/api/v1/teams/{team_id}/conventions/draft
Discard draft conventions
discardDraftConventions 1 param → 204401403404
POST
/api/v1/teams/{team_id}/conventions/publish
Publish conventions
publishConventions 1 param → 200400401403404
GET
/api/v1/teams/{team_id}/diagram
Get team diagram
getTeamDiagram 1 param → 200401403404
GET
/api/v1/teams/{team_id}/entities
Get team entities
getTeamEntities 1 param → 200401403404

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is ErrorResponse (2 properties). Each schema is shown below with its type and property counts.

ErrorResponse
object
Standard error response returned by all endpoints on failure.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

sageox-teams-api-openapi.yml Raw ↑

Other APIs Sageox publishes across the network.

Sageox Admin API
Sageox AgentX API
Sageox API Keys API
Sageox Auth API
Sageox CLI API
Sageox Devices API
Sageox Firmware Admin API
Sageox Firmware OTA API
Sageox Git API
Sageox Guidance API
Sageox Health API
Sageox LLM API
Where this information came from

This is an independent, third-party profile of Sageox Teams API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.