me.shops
Shops the signed-in person belongs to right now, with their role. A shop key gets only the one shop that key is bound to.
| |
|---|
| Who | Agents can call this |
| REST | GET /v1/me/shops |
| MCP tool | me_shops |
| Writes | no |
| Area | Shop |
When to use it
Shops the signed-in person belongs to right now, with their role. A shop key gets only the one shop that key is bound to.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
limit | integer | no |
cursor | string | no |
Example
GET https://doingwork.work/v1/me/shops?limit=1&cursor=...
Output
| Field | Type | Always there |
|---|
data | array | yes |
data[].shop_id | string (uuid) | yes |
data[].name | string | yes |
data[].role | string | yes |
next_cursor | ['string', 'null'] | yes |
{
"data": [
{
"shop_id": "00000000-0000-4000-8000-000000000000",
"name": "Ruiz Plumbing",
"role": "..."
}
],
"next_cursor": "..."
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |