# Mathematics Distillation Challenge: Equational Theories - Stage 1

Competition ID: `mathematics-distillation-challenge-equational-theories-stage1`

Use this guide when automating Stage 1 cheatsheet practice, publication, and formal submissions.

## Endpoint map

Use `competitionId = mathematics-distillation-challenge-equational-theories-stage1`.

**Competition endpoints**

| Task | Endpoint | Scope |
| :--- | :--- | :--- |
| Read schema | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1`](./api/get-competition.md#mathematics-distillation-stage-1) | `competition.read` |
| Check participation | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/me`](./api/get-my-participation.md#mathematics-distillation-stage-1) | `competition.read` |
| Submit cheatsheet | [`POST /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions`](./api/submit.md#mathematics-distillation-stage-1) | `competition.write` |
| Read current submissions | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions/mine`](./api/list-my-submissions.md#mathematics-distillation-stage-1) | `competition.read` |
| Read the current submission (legacy) | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions/me`](./api/get-my-submission-legacy.md#mathematics-distillation-stage-1) | `competition.read` |
| Read a submission by ID | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions/{submissionId}`](./api/get-submission.md#mathematics-distillation-stage-1) | `competition.read` |
| Download submitted cheatsheet text | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions/{submissionId}/download`](./api/download-submission.md#mathematics-distillation-stage-1) | `competition.read` |
| Read leaderboard | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/leaderboard`](./api/get-leaderboard.md#mathematics-distillation-stage-1-example) | `competition.read` |
| Read my standing | [`GET /api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/leaderboard/me`](./api/get-my-standing.md#null-example) | `competition.read` |

**Companion APIs**

- Manage private cheatsheet drafts with the [Cheatsheets](../cheatsheets.md) endpoints.
- Run practice jobs with the [Playground](../playground.md) endpoints.
- Publish or browse shared cheatsheets with the [Contributor Network](../contributor-network.md) endpoints.

## Submission payload

The competition uses `submissionSpec.kind: "cheatsheet"`.

**Example request body**

```json
{
  "payload": {
    "content": "When the equation has a neutral element, first try..."
  },
  "meta": {
    "description": "v3 - adds order-five heuristics.",
    "contributorNetworkItemId": "cn_01HX0PA..."
  }
}
```

Payload fields:

- `payload.content` is required. It is the cheatsheet text submitted for formal evaluation.
- `meta.description` is optional. Use it for a human-readable note in your own submission history.
- `meta.contributorNetworkItemId` is optional. Use it to record the Contributor Network item this submission references or builds on.

## Recommended workflow

1. Create or update a private cheatsheet with the [Cheatsheets](../cheatsheets.md) endpoints.
2. Use the [Playground](../playground.md) endpoints to test candidate cheatsheets against available problem sets and models.
3. Optionally publish useful work through [Contributor Network](../contributor-network.md).
4. Submit the final cheatsheet text through the competition submission endpoint.
5. Read `/submissions/mine` or download the stored text body to confirm the active submission. The collection contains zero or one item for this competition.

## Submit

```bash
curl -X POST "https://api.sair.foundation/api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/submissions" \
  -H "Authorization: Bearer $SAIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "content": "When the equation has a neutral element, first try..."
    },
    "meta": {
      "description": "Playground-tested cheatsheet."
    }
  }'
```

See [Competitions](../competitions.md) for the shared endpoint field tables.