Teams

Create team

Creates a team. Requires team:create (every Member holds it) or team:manage. Team names are unique within the organization. The caller becomes this team's administrator immediately — the same auto-ownership every other created resource gets — whether or not their own id also appears in member_ids. member_ids optionally adds other existing organization members (GET /member) as ordinary members in the same call; an id that is not already an org member fails the whole call before anything is created. To promote one of them to administrator too, follow up with PATCH /team/{id}/members/{userId}. There is no way to create a team you do not administer: to stand one up for somebody else, create it and appoint them; a team administrator cannot remove another administrator, themselves included, so taking yourself off afterwards needs a team:manage holder.

post/team

Request

  • Base URL: https://api.elaichi.ai
  • URL: https://api.elaichi.ai/team
  • Auth: HTTP bearer

Headers

X-Organization-Idstring

Target organization (org_…). Required for cookie/session auth on org-scoped routes; optional for API tokens, which carry their organization, and rejected when it names a different one.

Request body

namestring required
descriptionstring nullable
member_idsstring[]

User ids (usr_…) of existing organization members to add alongside the caller. Optional.

Response

Created

idstring

Team id (team_…).

namestring

Unique within the organization.

descriptionstring nullable
member_countinteger

How many people are in the team. The row carries no roster array; GET /team/{id}/member is the roster.

admin_countinteger

How many of them administer the team.

created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.