Raw schema
{
"type": "object",
"properties": {
"key": {
"description": "The issue the computation answers, e.g. 'MATH-74'.",
"type": "string"
},
"source": {
"description": "Who runs it, e.g. 'tm' or 'boinc'. The job's name is unique within it.",
"type": "string"
},
"externalId": {
"description": "The job's own name there, e.g. 'kimmy/gap/m74r5u'. The same name again updates the job.",
"type": "string"
},
"title": {
"description": "What it computes, in words, e.g. 'rank 5, order 2^11, stage C'.",
"type": [
"string",
"null"
],
"default": null
},
"state": {
"description": "queued, running, done, failed, cancelled or lost.",
"type": [
"string",
"null"
],
"default": null
},
"progressDone": {
"description": "How much is done, as the runner counts, e.g. 812.",
"type": [
"integer",
"null"
],
"default": null
},
"progressTotal": {
"description": "Out of how much, e.g. 1695.",
"type": [
"integer",
"null"
],
"default": null
},
"repository": {
"description": "The repository's web address, e.g. 'https://github.com/org/repo'.",
"type": [
"string",
"null"
],
"default": null
},
"commit": {
"description": "The commit it ran at.",
"type": [
"string",
"null"
],
"default": null
},
"command": {
"description": "How it was run: the command line or the job's description.",
"type": [
"string",
"null"
],
"default": null
},
"url": {
"description": "The job's own page on its runner (http/https).",
"type": [
"string",
"null"
],
"default": null
},
"outputUrl": {
"description": "Where its output can be fetched (http/https).",
"type": [
"string",
"null"
],
"default": null
},
"result": {
"description": "What came of it, a sentence or two. Markdown, $...$ formulas.",
"type": [
"string",
"null"
],
"default": null
},
"startedAt": {
"description": "When it started (ISO 8601). Left out, a move to running stamps now.",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"finishedAt": {
"description": "When it ended (ISO 8601). Left out, a move to a finished state stamps now.",
"type": [
"string",
"null"
],
"format": "date-time",
"default": null
},
"machine": {
"description": "The machine it ran on, e.g. 'kimmy', 'ax42', 'modal'.",
"type": [
"string",
"null"
],
"default": null
},
"cores": {
"description": "Cores allocated to it, e.g. 8 (or 0.5).",
"type": [
"number",
"null"
],
"default": null
},
"cpuSeconds": {
"description": "Processor time used so far, all cores together, in seconds β the running total, not an increment.",
"type": [
"number",
"null"
],
"default": null
},
"wallSeconds": {
"description": "Its wall clock in seconds, where the runner counts it otherwise than end minus start.",
"type": [
"number",
"null"
],
"default": null
},
"gpuSeconds": {
"description": "GPU time in seconds, where there was one.",
"type": [
"number",
"null"
],
"default": null
},
"gpuType": {
"description": "The GPU's type, e.g. 'H100', 'A100-80GB', 'L4' β what a tariff prices a GPU-second by.",
"type": [
"string",
"null"
],
"default": null
},
"memoryGiB": {
"description": "Memory allocated to it in GiB β billed by a tariff such as Modal's.",
"type": [
"number",
"null"
],
"default": null
},
"costUsd": {
"description": "What the service itself billed for the job, in US dollars, where you know it (Modal's billing report). It wins over the cost worked out from the price list.",
"type": [
"number",
"null"
],
"default": null
}
},
"required": [
"key",
"source",
"externalId"
]
}