Give a board to a team
Gives the board to another team, whose members then see it. The
board's own team already sees a team board and cannot be added.
Giving it to a team that already has it changes nothing. A role in
the body is accepted and ignored.
Requires the board:member:write scope.
Authorization
Parameters
Path parameters
boardIDstring requiredThe board's ID.
Request body required
team_idstring requiredrolestring deprecatedIgnored.
Responses
201
The team has the board.
dataobjectteamTeamShareShow TeamShare properties
board_idstringorg_idstringteam_idstringadded_bystringadded_atstring (date-time)
400
The body is not JSON for this endpoint (INVALID_BODY), team_id is missing, or it is the board's own team (VALIDATION_ERROR).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
404
It does not exist, or it is on a board the caller cannot see (NOT_FOUND).
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X POST 'https://evohub.io/api/v1/board/boards/brd_5b0c8e1a2f3d4c6b9a7e0d1f2c3b4a59/teams' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"team_id": "team_1c3e5a7b-2d4f-4a6c-8e0b-9f1a2b3c4d5e"
}'
