---
title: "Cancel learning or resume delivery of a saved result"
method: POST
path: "/learning/jobs/{jobId}/control"
tags: ["Exports and Jobs"]
---

# Cancel learning or resume delivery of a saved result

`POST /learning/jobs/{jobId}/control`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/learning/jobs/{jobId}/control`
- Auth: API key in header `Authorization`

Cancel learning or resume delivery of a saved result.

## Path parameters

- `jobId` string, uuid, required

## Request body

- object
  - `action` 'resume' | 'cancel', required

## Response `200`

Successful response

- object
  - `id` string, uuid, required
  - `status` 'queued' | 'generating' | 'saving' | 'complete' | 'unknown' | 'cancelled' | 'failed', required
  - `evidence` object, required
    - `fingerprint` string, required
    - `capturedAt` string, date-time, required
    - `seriesName` string, required
    - `request` object, required
      - `seriesId` string, uuid, required
      - `goal` 'reach' | 'engagement' | 'traffic' | 'leads' | 'sales' | 'revenue', required
      - `from` string, date-time, required
      - `to` string, date-time, required
      - `maxVariations` integer, required
      - `language` 'en' | 'fr', required
    - `context` object, required
      - `direction` object, required
        - `capturedAt` string, required
        - `scope` object, required
          - `kind` 'brand' | 'series', required
          - `seriesId` string, uuid, nullable, required
          - `name` string, required
        - `brand` object, required
          - `title` string, required
          - `sources` object[], required
            - `url` string, uri, required
            - `title` string, required
          - `path` string, required
          - `documentId` string, uuid, nullable, required
          - `revision` integer, required
          - `markdown` string, required
          - `contentHash` string, required
        - `series` object, nullable, required
          - `title` string, required
          - `sources` object[], required
            - `url` string, uri, required
            - `title` string, required
          - `path` string, required
          - `documentId` string, uuid, nullable, required
          - `revision` integer, required
          - `markdown` string, required
          - `contentHash` string, required
      - `precedence` string[], required
      - `documents` object[], required
        - `id` string, uuid, required
        - `path` string, required
        - `title` string, required
        - `kind` 'brief' | 'research' | 'correction' | 'reference', required
        - `revision` integer, required
        - `updatedAt` string, required
        - `content` object, required
          - `documentId` string, uuid, required
          - `revision` integer, required
          - `title` string, required
          - `kind` 'brief' | 'research' | 'correction' | 'reference', required
          - `markdown` string, required
          - `sources` object[], required
            - `url` string, uri, required
            - `title` string, required
          - `authorUserId` string, nullable, required
          - `origin` 'web' | 'agent' | 'legacy' | 'seed', required
          - `sourceRef` string, nullable, required
          - `contentHash` string, required
          - `createdAt` string, required
      - `bounds` object, required
        - `limit` number, required
        - `offset` number, required
        - `total` number, required
        - `returned` number, required
        - `hasMore` boolean, required
        - `truncated` boolean, required
      - `characterLimit` number, required
      - `truncatedDocumentIds` string[], required
    - `observations` object[], required
      - `id` string, required
      - `kind` 'metric' | 'review' | 'click' | 'outcome', required
      - `anchor` string, required
      - `projectId` string, uuid, nullable, required
      - `creativeRevision` string, nullable, required
      - `accountId` string, uuid, nullable, required
      - `format` 'video' | 'carousel' | 'image', nullable, required
      - `observedAt` string, date-time, nullable, required
      - `sourceUrl` string, uri, required
      - `summary` string, required
      - `value` number, nullable, required
      - `unit` string, required
      - `attribution` 'observed' | 'self_reported' | 'unknown', required
      - `cohort` string, nullable, required
      - `eligible` boolean, required
      - `details` object, required
    - `comparisons` object[], required
      - `cohort` string, required
      - `samples` integer, required
      - `median` number, nullable, required
      - `status` 'descriptive_comparison' | 'insufficient_evidence', required
      - `observationIds` string[], required
    - `bounds` object, required
      - `metricLimit` 100, required
      - `reviewLimit` 30, required
      - `editLimit` 30, required
      - `linkLimit` 30, required
      - `outcomeLimit` 30, required
      - `truncated` boolean, required
    - `authorityComplete` boolean, required
  - `documents` object[], required
    - `id` string, uuid, required
    - `path` string, required
    - `title` string, required
    - `kind` 'brief' | 'research' | 'correction' | 'reference', required
    - `revision` integer, required
    - `updatedAt` string, required
  - `proposal` object, nullable, required
    - `lesson` string, required
    - `evidenceIds` string[], required
    - `limitations` string[], required
    - `variations` object[], required
      - `title` string, required
      - `axis` 'hook' | 'format' | 'pacing' | 'cta' | 'topic' | 'visual', required
      - `observationId` string, required
      - `hypothesis` string, required
      - `brief` string, required
      - `measure` string, required
  - `error` string, nullable, required
  - `direction` 'current' | 'changed' | 'unavailable', required
  - `runId` string, nullable, required
  - `canResume` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)