Change a support team

.md

A new name and the whole list of members of a support team.

Scopesadmin:write
Permissionmanage_support_settings
PUT/v1/admin/support-teams/{team}

Rename one of the firm's support teams, and set who is on it. Send the name and the whole list of members every time, including the ones who stay. The tickets given to the team stay with it.

Needs a firm. Our own staff name one with the Propper-Workspace header.

Request

Both fields, as in create.

curl -X PUT "https://api.proppertrading.com/v1/admin/support-teams/team_xmwh3fde7wym7xkj" \
  -H "Authorization: Bearer ptat_9f2c1a44_3b8e7d2f5c9a1b4e6d8f0a2c4e6b8d1f" \
  -H "Propper-Workspace: acme" \
  -H "Content-Type: application/json" \
  -d '{"name": "Platform and data", "member_ids": ["usr_afekquw8p97wv6tb", "usr_pj68ba8tmrbb7fxb"]}'

Response

{
    "data": {
        "object": "support_team",
        "id": "team_xmwh3fde7wym7xkj",
        "name": "Platform and data",
        "members": [
            {
                "id": "usr_pj68ba8tmrbb7fxb",
                "name": "Ios Tester"
            },
            {
                "id": "usr_afekquw8p97wv6tb",
                "name": "Sam Carter"
            }
        ],
        "open": 0,
        "mine": true
    },
    "meta": {
        "request_id": "req_01m50v1n4zbnawg9p3zyf8az71"
    }
}

Errors

StatusCodeMeaning
400workspace_requiredAsked by our own staff without naming a firm
401invalid_tokenNot a token, or the secret does not match
401revoked_tokenSigned out here or from another device
401expired_tokenNinety days without use, or a set expiry passed
403admin_access_requiredThis account no longer helps run the environment
403insufficient_scopeThis device does not hold admin:write
403workspace_not_permittedThe Propper-Workspace header names an environment this account cannot act in
403forbiddenWithout manage_support_settings
404resource_not_foundNo support team with that id in this firm
422validation_failedNo name, a name another team has, no member_ids, more than 200, or a member who is not one of the firm's agents