me.start
Start here. Shops this connection can use, the grant in plain words, counts, and the next tasks for the state of each shop.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/me/start |
| MCP tool | me_start |
| Writes | no |
| Area | Shop |
When to use it
Start here. Shops this connection can use, the grant in plain words, counts, and the next tasks for the state of each shop.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
Example
GET https://doingwork.work/v1/me/start?
Output
| Field | Type | Always there |
|---|
grant | string | yes |
binding | string | yes |
bound_shop_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
shops | array | yes |
shops[].shop_id | string (uuid) | yes |
shops[].name | string | yes |
shops[].role | string | yes |
shops[].customers | integer | yes |
shops[].open_jobs | integer | yes |
shops[].draft_quotes | integer | yes |
shops[].open_invoices | integer | yes |
can | array | yes |
cannot | array | yes |
tasks | array | yes |
tasks[].shop_id | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes |
tasks[].say | string | yes |
tasks[].tool | string | yes |
tasks[].argument | string | yes |
next_actions | array | yes |
next_actions[].say | string | yes |
next_actions[].op | ['string', 'null'] | yes |
next_actions[].when | string (one of now, later, check, tell_human) | yes |
next_actions[].due_at | ['string', 'null', ' ', '(', 'd', 'a', 't', 'e', '-', 't', 'i', 'm', 'e', ')'] | no |
next_actions[].args_hint | string | no |
fees | object | yes |
fees.tool | string | yes |
fees.say | string | yes |
approvals | object | yes |
approvals.tool | string | yes |
approvals.say | string | yes |
next | string | yes |
{
"grant": "...",
"binding": "...",
"bound_shop_id": "00000000-0000-4000-8000-000000000000",
"shops": [
{
"shop_id": "00000000-0000-4000-8000-000000000000",
"name": "Ruiz Plumbing",
"role": "...",
"customers": 1,
"open_jobs": 1,
"draft_quotes": 1,
"open_invoices": 1
}
],
"can": [
"..."
],
"cannot": [
"..."
],
"tasks": [
{
"shop_id": "00000000-0000-4000-8000-000000000000",
"say": "...",
"tool": "...",
"argument": "..."
}
],
"next_actions": [
{
"say": "...",
"op": "...",
"when": "now"
}
],
"fees": {
"tool": "...",
"say": "..."
},
"approvals": {
"tool": "...",
"say": "..."
},
"next": "..."
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |