# Plain Text Jobs

Submit raw SimulationCraft profile text directly via `POST /v1/simc/jobs` with `Content-Type: text/plain`. No JSON envelope needed.

> `text/plain` is a convenience for `curl` and shell pipelines, not a separate API contract. The JSON envelope (`Content-Type: application/json`) is the canonical contract and exposes the full request surface (see Limitations below). Reach for plain text when you're piping a `.simc` file straight from the shell.

## Example

```bash
curl -X POST "https://api.simmit.com/v1/simc/jobs?channel=nightly&multiStage=true" \
  -H "Authorization: Bearer $SIMMIT_SECRET_KEY" \
  -H "Content-Type: text/plain" \
  --data-binary @profile.simc
```

## Query Parameters

Booleans must be the literal strings `"true"` or `"false"`. The request body is the profile text (maps to `profile.text` in JSON).

```yaml
# Build
channel: 'nightly | weekly | latest' # required → build.channel
gitBranch: 'midnight' # → build.gitBranch

# Scheduling
priority: 'standard | high' # default: standard

# Runtime
multiStage: true # Multistage execution → runtime.multiStage
maxRuntimeSeconds: 3600 # Max job runtime in seconds → runtime.maxRuntimeSeconds
maxQueueSeconds: 600 # Max queue wait before timeout → runtime.maxQueueSeconds

# Webhooks
webhookEvents: 'job.terminal' # Comma-separated → webhook.events

# Artifacts
artifactsHtml: true # Produce HTML report → artifacts.html
artifactsCsv: true # Produce CSV result table → artifacts.csv
artifactsJsonVersion: '2 | 3' # 2 = stable, 3 = experimental → artifacts.json.version
```

## Headers

Optional headers:

```yaml
X-Bnet-Client-Id: '...' # Battle.net client ID (must pair with secret)
X-Bnet-Client-Secret: '...' # Battle.net client secret (must pair with ID)
```

## Limitations

The following are **only available via the JSON body** (`Content-Type: application/json`):

- **`metadata`**: opaque key-value map for client-side correlation/labeling (up to 20 entries, 1 KB total).
- **`credentials`**: available via headers (see above), not query params.

---

_HTML version: https://docs.staging.simmit.gg/docs/api/plain-text-submission · Full docs index: https://docs.staging.simmit.gg/llms.txt_