# Submit seeds & topics

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

Source: https://math-api.qmindlabs.ai/docs/guides/seeds

## 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:

```sh
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](https://math-api.qmindlabs.ai/docs/api-reference/tag/seeds-topics/POST/api/math/seed-submissions.md)

## 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-submissions](https://math-api.qmindlabs.ai/docs/api-reference/tag/seeds-topics/GET/api/math/seed-submissions.md)

[GET/api/math/seed-submissions/{submission\_id}](https://math-api.qmindlabs.ai/docs/api-reference/tag/seeds-topics/GET/api/math/seed-submissions/%7Bsubmission_id%7D.md)

## What happens next

**Intake only**

Submissions are stored durably in AWS but do not automatically start an evaluation. A pipeline operator must launch the question\_id and proposition separately. The API has no launch, edit, delete or dispatch endpoint yet.

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.
