/api/v1/workspaces/{workspace_id}/teams/{team}Change a team
Leads and workspace admins: name, icon, colour, description, Slack channel, Jira projects and weekly digest. visibility: workspace admins only.
Path parameters
#workspace_idstringRequiredThe workspace's id, from the address of its settings page (
markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.teamstringRequired
Request body
#application/json, required
namestring1–80 characters.
iconstringUp to 16 characters.
color"blue" | "green" | "amber" | "red" | "violet" | "pink" | "teal" | "gray"descriptionstringUp to 400 characters.
visibility"open" | "private"slack_channelobject2 fields inside
idstringRequired1–40 characters.
namestringUp to 80 characters.
slack_commentsbooleanPost new and resolved comments on the team's items to its Slack channel (default on).
jira_projectsarray of stringUp to 20 items.
digestobject3 fields inside
enabledbooleanDefault
true.emailbooleanDefault
true.slackbooleanDefault
true.
meetings_by_attendeesbooleanAdd new meetings to this team when its members are half or more of the attendees (default on). Off: only meetings imported or moved into it, such as from Zoom.
backlogbooleanKeep the team's backlog page up to date from its calls (default on; not General). Off: the page stays as it is and leaves the sidebar.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.