Save one field role's settings and replace its people

PUT

https://api.channelautomation.com/api/field-sales/field-roles/{key}

Path parameters

key
marketing
or
sales
or
installation
required

Request body JSON

checkin_radius_m
optional
integer
maximum: 2000 · minimum: 25
alert_on_site_minutes
optional
integer
or null
maximum: 1440 · minimum: 15
member_user_ids
optional
array of
string
format: uuid
expected_member_user_ids
optional
array of
string
Members the editor loaded; a changed roster returns 409 roster_changed

format: uuid

Returns

200

Saved

400

Invalid input

403

Owners and admins only

409

Someone in the list is not a client team member of this workspace

Save one field role's settings and replace its people

curl --request PUT \
  --url https://api.channelautomation.com/api/field-sales/field-roles/marketing \
  --header 'Content-Type: application/json' \
  --data '
{
  "checkin_radius_m": 25,
  "alert_on_site_minutes": 15,
  "member_user_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ],
  "expected_member_user_ids": [
    "497f6eca-6276-4993-bfeb-53cbbbba6f08"
  ]
}
'

const url = 'https://api.channelautomation.com/api/field-sales/field-roles/marketing';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    checkin_radius_m: 25,
    alert_on_site_minutes: 15,
    member_user_ids: ['497f6eca-6276-4993-bfeb-53cbbbba6f08'],
    expected_member_user_ids: ['497f6eca-6276-4993-bfeb-53cbbbba6f08']
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/field-sales/field-roles/marketing"

payload = {
    "checkin_radius_m": 25,
    "alert_on_site_minutes": 15,
    "member_user_ids": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"],
    "expected_member_user_ids": ["497f6eca-6276-4993-bfeb-53cbbbba6f08"]
}
headers = {"Content-Type": "application/json"}

response = requests.put(url, json=payload, headers=headers)

print(response.text)