PATCH/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.

API token required120 per minute per IPMCP: update_team
Code samples and Try it

Path parameters

#
  • workspace_idstringRequired

    The 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

  • namestring

    1–80 characters.

  • iconstring

    Up to 16 characters.

  • color"blue" | "green" | "amber" | "red" | "violet" | "pink" | "teal" | "gray"
  • descriptionstring

    Up to 400 characters.

  • visibility"open" | "private"
  • slack_channelobject
    2 fields inside
    • idstringRequired

      1–40 characters.

    • namestring

      Up to 80 characters.

  • slack_commentsboolean

    Post new and resolved comments on the team's items to its Slack channel (default on).

  • jira_projectsarray of string

    Up to 20 items.

  • digestobject
    3 fields inside
    • enabledboolean

      Default true.

    • emailboolean

      Default true.

    • slackboolean

      Default true.

  • meetings_by_attendeesboolean

    Add 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.

  • backlogboolean

    Keep 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. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
Did this page help?