POST https://ed.link/api/v2/teams
Creates a new team and adds the authenticated user as an owner. Valid team types: school, district, university, department, developer, other.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the team |
type | string | Yes | Team type (see above) |
alias | string | No | URL-safe identifier; auto-generated if omitted |
Sample Request
const response = await axios.post(
'https://ed.link/api/v2/teams',
{
name: 'Acme School District',
type: 'district',
alias: 'acme-isd'
},
{
headers: {
authorization: `Bearer ${user_session_token}`
}
}
);
Sample Response
{
"$data": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"created_date": "2026-08-11T18:30:00.000Z",
"updated_date": "2026-08-11T18:30:00.000Z",
"name": "Acme School District",
"type": "district",
"state": "active",
"alias": "acme-isd",
"verified": false,
"mfa_required": false,
"billing_enabled": false
}
}