Start et job

Start en kladde, så den kommer i kø til behandling.

POSThttps://api.grundfast.dk/v1/jobs/{id}/start

Gælder kun et job i status draft med mindst én række.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Afregning

Ikke målt.

Eksempel

curl -X POST "https://api.grundfast.dk/v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b/start" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "job": {
    "id": "job_4n8q2v7k1m9x3c5z0w6r2t8b",
    "kind": "datavask",
    "status": "queued",
    "label": "Kundeliste oktober",
    "totalRows": 2,
    "processedRows": 0,
    "succeeded": 0,
    "failed": 0,
    "billedUnits": 0,
    "progress": 0,
    "columns": { "adresse": "adresse" },
    "srid": 4326,
    "inputColumns": ["kunde", "adresse"],
    "error": null,
    "createdAt": "2026-10-05T09:12:03.418Z",
    "startedAt": null,
    "completedAt": null,
    "updatedAt": "2026-10-05T09:12:05.117Z",
    "resultsAvailable": true
  }
}

Parametre

idstringstipåkrævet: Jobbets id fra job.id.Eksempel: job_4n8q2v7k1m9x3c5z0w6r2t8b

Felter i svaret

job.statusstring: queued efter kaldet.

Statuskoder

Status	Betydning
200	Svaret er leveret.
401	Hverken en gyldig nøgle eller en session.
403	Nøglen er en admin-nøgle, eller kontoen er suspenderet.
404	Der findes intet job med det id på din konto.
409	Jobbets status tillader ikke handlingen, fx at sætte et færdigt job på pause.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Bruges ofte sammen med

curl -X POST "https://api.grundfast.dk/v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b/start" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · eksempel200json

{
  "job": {
    "id": "job_4n8q2v7k1m9x3c5z0w6r2t8b",
    "kind": "datavask",
    "status": "queued",
    "label": "Kundeliste oktober",
    "totalRows": 2,
    "processedRows": 0,
    "succeeded": 0,
    "failed": 0,
    "billedUnits": 0,
    "progress": 0,
    "columns": { "adresse": "adresse" },
    "srid": 4326,
    "inputColumns": ["kunde", "adresse"],
    "error": null,
    "createdAt": "2026-10-05T09:12:03.418Z",
    "startedAt": null,
    "completedAt": null,
    "updatedAt": "2026-10-05T09:12:05.117Z",
    "resultsAvailable": true
  }
}