Quickstart

1. Get an API key

Ask your Math workspace administrator for a key with read. Add files:read to download reports and paths:read if you need storage locations. Store it in your secret manager or a private MATH_API_KEY environment variable.

2. Verify your access

curl --fail-with-body 'https://math-api.qmindlabs.ai/api/auth/session' \
  -H "Authorization: Bearer $MATH_API_KEY"

The response includes your effective role and scopes. A reviewer sees assigned tasks; an owner or administrator has broader Math access.

3. Find your tasks

curl --fail-with-body 'https://math-api.qmindlabs.ai/api/math/tasks?page=1&page_size=25' \
  -H "Authorization: Bearer $MATH_API_KEY"

Use each task’s id from tasks[] as the task_id path parameter. Filter by question_id, review_state, reviewer_id, or q. The default surface=all includes archived tasks.

4. Read the workflow

curl --fail-with-body 'https://math-api.qmindlabs.ai/api/math/tasks/TASK_ID/workflow' \
  -H "Authorization: Bearer $MATH_API_KEY"

Replace TASK_ID with an ID from your response. This returns the task’s current version, assignment, decision, and history.

Next steps