Workspaces API
List and create workspaces and manage their members — api.misar.io/reach/api/workspaces.
Workspaces group teammates and shared MisarReach data. Every operation in this family is rate-limited (api tier).
Base URL: https://api.misar.io/reach/api · Auth: Authorization: Bearer mrk_…
Response bodies on the developer contract are open-form — the examples below show representative fields.
List workspaces
/api/workspacesReturns the workspaces the caller belongs to. Required scope: workspaces:read.
curl https://api.misar.io/reach/api/workspaces \
-H "Authorization: Bearer mrk_your_key_here"{ "workspaces": [{ "id": "uuid", "name": "Acme Sales", "role": "owner" }] }Create a workspace
/api/workspacesCreates a new workspace owned by the caller. Required scope: workspaces:write.
Request body
namestringbodyrequiredcurl -X POST https://api.misar.io/reach/api/workspaces \
-H "Authorization: Bearer mrk_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "name": "Acme Sales" }'{ "ok": true, "workspace": { "id": "uuid", "name": "Acme Sales" } }List members
/api/workspaces/:id/membersReturns the members of a workspace. Required scope: workspaces:read.
Path parameters
idstringpathrequiredcurl https://api.misar.io/reach/api/workspaces/WORKSPACE_ID/members \
-H "Authorization: Bearer mrk_your_key_here"{ "members": [{ "user_id": "uuid", "email": "teammate@acme.com", "role": "member" }] }Add / remove a member
/api/workspaces/:id/membersAdd (POST) or remove (DELETE) a workspace member. Required scope: workspaces:write.
Path parameters
idstringpathrequiredPOST body
emailstringbodyrequiredrolestringbodymember or admin.curl -X POST https://api.misar.io/reach/api/workspaces/WORKSPACE_ID/members \
-H "Authorization: Bearer mrk_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "email": "teammate@acme.com", "role": "member" }'curl -X DELETE https://api.misar.io/reach/api/workspaces/WORKSPACE_ID/members \
-H "Authorization: Bearer mrk_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "user_id": "uuid" }'{ "ok": true }Status codes
| Code | Meaning |
|---|---|
200 | Workspaces / members returned, member removed |
201 | Workspace created or member added |
403 | Missing workspaces:read / workspaces:write scope |
404 | Workspace not found or caller is not a member |
429 | Rate limit exceeded — retry after Retry-After |
See Rate limits and Errors.