shops.sendPermissions

What each role may send to a customer: quotes, invoices and visit recaps. The owner always may, for every job, and is not listed. Office starts able to send all three for any job. A lead starts able to send all three for jobs on their crew. A field worker starts able to send all three for jobs assigned to them. The owner can turn any of these off. A missing row means the default, which is on.

WhoAgents can call this
RESTGET /v1/shops/send-permissions
MCP toolshops_sendPermissions
Writesno
AreaShop

When to use it

What each role may send to a customer: quotes, invoices and visit recaps. The owner always may, for every job, and is not listed.

What to tell the owner

Tell them what you found in plain words. Don't read back raw fields.

Input

FieldTypeRequired
shop_idstring (uuid)yes

Example

GET https://doingwork.work/v1/shops/send-permissions?shop_id=00000000-0000-4000-8000-000000000000

Output

FieldTypeAlways there
shop_idstring (uuid)yes
ownerstringyes
rolesarrayyes
roles[].rolestring (one of office, lead, field)yes
roles[].send_quotesbooleanyes
roles[].send_invoicesbooleanyes
roles[].send_recapsbooleanyes
roles[].scopestringyes
roles[].customizedbooleanyes
{
  "shop_id": "00000000-0000-4000-8000-000000000000",
  "owner": "...",
  "roles": [
    {
      "role": "office",
      "send_quotes": true,
      "send_invoices": true,
      "send_recaps": true,
      "scope": "...",
      "customized": true
    }
  ]
}

Errors

CodeStatusWhat to do
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.