Teams API

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