Skip to main content
Change a member’s role, or remove them from the team. Both actions require admin role. Removing the last admin is rejected.

​
Update role

curl -X PATCH https://app.dacard.ai/api/teams/tm_2x1B3y/members/tmm_xyz \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "role": "scorer" }'

​
Remove member

curl -X DELETE https://app.dacard.ai/api/teams/tm_2x1B3y/members/tmm_xyz \
  -H "Authorization: Bearer $DACARD_API_KEY"
PropertyValue
AuthRequired
Required scopeCaller must be a team admin
IdempotentPATCH yes. DELETE yes (returns 404 on second call).

​
Roles

RoleCan scoreCan inviteCan change rolesCan remove members
adminyesyesyesyes
scoreryesnonono
viewernononono

​
Errors

StatusCodeWhen
400role must be one of: admin, scorer, viewerBad role on PATCH.
401AUTH_REQUIREDNo session.
403Only team admins can change rolesCaller is not admin.
404Member not foundBad memberId.
409Cannot remove the last adminDELETE on the only admin.
500INTERNAL_ERRORWrite failed.
Audit log entries: team_member_role_changed, team_member_removed.