QMindMath developers

Guides

Markdown ↗

Submit seeds & topics

Save a new Math proposition for later evaluation, with safe retries and a durable receipt.

Submit a proposition

Owners and admins with write can create a pending submission. Generate a new UUID for client_request_id once per intended submission. Store it locally before sending the request; reuse it and the same content after a timeout.

JSON
{
  "client_request_id": "11111111-2222-4333-8444-555555555555",
  "title": "Prime divisors of a square plus one",
  "proposition": "Prove that every odd prime divisor of n squared plus one is congruent to one modulo four."
}

Save your input as seed.json, replacing the example UUID with your own. Then send it:

cURL
curl --fail-with-body 'https://math-api.qmindlabs.ai/api/math/seed-submissions' \
  -H "Authorization: Bearer $MATH_API_KEY" -H 'Content-Type: application/json' --data-binary @seed.json
POSTRequest and response schema

Read the receipt and retry safely

A new submission returns 201 and submission with its UUID, generated question_id, title, proposition, creator, key ID, timestamp, status: PENDING, and evaluation_started: false. Identical retries return 200 and the original receipt. A reused request ID with different trimmed content returns 409 seed_submission_conflict; do not overwrite it blindly.

Use read to list submissions or retrieve full text. Lists omit the proposition to keep pagination small.

GET/api/math/seed-submissionsGET/api/math/seed-submissions/{submission_id}

What happens next

New submissions are currently accessible through the API; the dashboard has no submission queue page. Existing GET /api/math/seeds and GET /api/math/topics continue to list imported results. A saved submission does not create a completed run, task or report.