PUT/api/v1/team/{workspace_id}/groups/{group_id}

Change a group

Admins: rename a group or change its members (the whole list).

API token required30 per minute per IP

Guide: Team: your workspace memory

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

Request body

application/json, required

namestringRequired
1–80 characters.
member_idsarray of string
Up to 500 items.

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.

bash

curl -X PUT https://api.markdrop.in/api/v1/team/WORKSPACE_ID/groups/GROUP_ID \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sourcing team","member_ids":["USER_ID"]}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/team/WORKSPACE_ID/groups/GROUP_ID", {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Sourcing team",
    "member_ids": [
      "USER_ID"
    ]
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.put(
    "https://api.markdrop.in/api/v1/team/WORKSPACE_ID/groups/GROUP_ID",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"name": "Sourcing team", "member_ids": ["USER_ID"]},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

workspace_idrequired

group_idrequired

namerequired

member_ids

Your request

curl -X PUT https://api.markdrop.in/api/v1/team/WORKSPACE_ID/groups/GROUP_ID \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sourcing team","member_ids":["USER_ID"]}'

This calls the live API as you. Changes are real.

I understand, send real requests from this page

Tick the box above to send. Or copy the command and run it in a terminal.

Did this page help?