Teams API

Create and manage teams through the Ionhour API — add and remove members, list team rosters, and target entire teams in notifications and escalation paths.

Teams group workspace members together for use as escalation targets. See Teams for conceptual documentation.

These are dashboard API endpoints — they require an OAuth session token ($ACCESS_TOKEN) and do not accept ionh_ API keys. The MCP integration offers API-key access to member listing and invitation management; team CRUD is dashboard-only. See which credential goes where.

Create Team

POST /teams

Request Body

Field	Type	Required	Description
`workspaceId`	number	Yes	Workspace this team belongs to
`name`	string	Yes	Team name
`description`	string	No	Team description

Example

curl -X POST https://api.ionhour.com/api/teams \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": 1,
    "name": "Platform Engineering",
    "description": "Responsible for core infrastructure and platform services"
  }'

List Teams

GET /teams

Query Parameters

Parameter	Type	Required	Description
`workspaceId`	number	Yes	Filter by workspace

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.ionhour.com/api/teams?workspaceId=1"

Get Team

GET /teams/:id

Returns a team with its members.

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://api.ionhour.com/api/teams/1

Update Team

PUT /teams/:id

curl -X PUT https://api.ionhour.com/api/teams/1 \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "SRE Team"}'

Delete Team

DELETE /teams/:id

curl -X DELETE https://api.ionhour.com/api/teams/1 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Team Members

Add Member

POST /team-members

Field	Type	Required	Description
`teamId`	number	Yes	Team to add the member to
`userId`	number	Yes	User to add

curl -X POST https://api.ionhour.com/api/team-members \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"teamId": 1, "userId": 42}'

Remove Member

DELETE /team-members/:id

curl -X DELETE https://api.ionhour.com/api/team-members/5 \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Teams API

On this page