Start an import job

POST

/api/v1/recipes/import-previews/{preview_id}/jobs

const url = 'http://127.0.0.1:8080/api/v1/recipes/import-previews/example/jobs';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"item_ids":["example"],"on_duplicate":"reject","resolutions":[{"action":"separate","item_id":"example","target_entry_id":"example"}],"retain_source_item_ids":["example"]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url http://127.0.0.1:8080/api/v1/recipes/import-previews/example/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "item_ids": [ "example" ], "on_duplicate": "reject", "resolutions": [ { "action": "separate", "item_id": "example", "target_entry_id": "example" } ], "retain_source_item_ids": [ "example" ] }'

Takes the selected recipes out of the review session and imports them as durable work. The response is a job to watch rather than a result to wait for: closing the page, losing the connection, or restarting Savorum does not abandon the import. Recipes are committed in batches, so partial success is preserved and inspectable recipe by recipe.

Authorizations

bearerToken
browserSession

Parameters

Path Parameters

preview_id

required

string

Header Parameters

Idempotency-Key

string

<= 200 characters

Request Body^required

application/json

object

item_ids

Array<string> | null

<= 500 items

on_duplicate

string

Allowed values: reject skip replace

resolutions

Array<object> | null

<= 500 items

object

action

required

string

Allowed values: separate update skip

item_id

required

string

target_entry_id

string

retain_source_item_ids

Uploaded preview item IDs whose original files should be retained

Array<string> | null

<= 500 items

Responses

202

Accepted

application/json

object

job

required

object

cancellation_requested_at

string format: date-time

created_at

required

string format: date-time

error

string

finished_at

string format: date-time

required

string

importer

required

The source formats this import came from, in the reader’s words

string

lead_title

The title of this job’s first recipe, for naming the import by what it brought

string

on_duplicate

required

string

Allowed values: reject skip replace

progress

required

object

cancelled

required

integer format: int64

current_batch

required

The one-based batch being processed, zero before work starts

integer format: int64

diagnostic_occurrences

required

integer format: int64

diagnostics

required

Array<object> | null

object

area

required

string

class

required

string

Allowed values: blocking actionable informational

code

required

string

message

required

string

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

key

additional properties

any

failed

required

integer format: int64

finished

required

integer format: int64

imported

required

integer format: int64

informational_preservation

required

integer format: int64

pending

required

integer format: int64

resumable

required

Unfinished recipes Savorum still holds enough of to run again

integer format: int64

review_required

required

integer format: int64

running

required

integer format: int64

skipped

required

integer format: int64

total

required

integer format: int64

total_batches

required

integer format: int64

>= 1

without_diagnostics

required

integer format: int64

key

additional properties

any

resolution_decisions

required

Array<object> | null

object

affected_ingredient_count

required

integer format: int64

affected_occurrence_ids

required

Array<string> | null

affected_recipe_count

required

integer format: int64

convention

string

convention_unit_ids

Array<string> | null

decision_scope

required

string

excluded_item_ids

Array<string> | null

excluded_occurrence_ids

Array<string> | null

impact_digest

required

string

interpretation_kind

required

string

original_actionable_count

required

integer format: int64

parser_version

required

string

resolution_kind

required

string

resulting_actionable_count

required

integer format: int64

scope_ingredient_ids

Array<string> | null

scope_occurrence_keys

Array<string> | null

unit_id

string

unit_registry_version

required

string

key

additional properties

any

source

required

What was chosen: a filename, several, or the format when there was no file

string

started_at

string format: date-time

state

required

string

Allowed values: pending running completed completed-with-errors cancelled failed interrupted

total_items

required

integer format: int64

key

additional properties

any

remaining

object

expires_at

required

string format: date-time

required

string

items

required

Array<object> | null

object

already_here

required

boolean

analysis

required

object

matches

required

Array<object> | null

object

authors

required

Array<string> | null

entry_id

required

string

evidence

required

string

Allowed values: source-identity canonical-url portable-id similarity

ingredient_count

required

integer format: int64

recipe_id

required

string

revision

required

integer format: int64

>= 1

score

required

number format: double

<= 1

title

required

string

yield

string

key

additional properties

any

status

required

string

Allowed values: new definite-match likely-duplicate ambiguous

key

additional properties

any

assets

required

object

available

required

integer format: int64

deferred

required

integer format: int64

discovered

required

integer format: int64

failed

required

integer format: int64

preview_url

Retrieves this recipe’s leading photograph on demand; answers 404 with a problem type saying whether it is pending or unavailable

string

unavailable

required

integer format: int64

key

additional properties

any

can_commit

required

boolean

diagnostics

required

Array<object> | null

object

area

required

string

class

required

string

Allowed values: blocking actionable informational

code

required

string

count

required

integer format: int64

>= 1

message

required

string

severity

required

string

Allowed values: info warning error

targets

Array<object> | null

object

action

string

evidence

string

field

string

object_id

string

preserved

string

resolution

object

authored_form

required

string

candidate_unit_ids

required

Array<string> | null

required

string

kind

required

string

resolution_key

required

string

source_end

required

integer format: int64

source_start

required

integer format: int64

key

additional properties

any

key

additional properties

any

key

additional properties

any

required

string

recipe

required

object

description

string

ingredient_count

required

integer format: int64

ingredients

Array<object> | null

object

items

required

Array<string> | null

title

string

key

additional properties

any

instructions

Array<object> | null

object

items

required

Array<string> | null

title

string

key

additional properties

any

step_count

required

integer format: int64

title

required

string

yield

string

key

additional properties

any

source

required

object

attribution

string

can_retain

required

The uploaded original can be retained explicitly when this preview item is committed

boolean

extracted_text

Text extracted from a document upload, editable before commit

string

filename

string

format_id

required

string

format_name

required

string

url

string

key

additional properties

any

key

additional properties

any

preview_revision

required

integer format: int64

>= 1

resolution_decisions

required

Array<object> | null

object

authored_forms

required

Array<string> | null

candidate_unit_ids

required

Array<string> | null

choices

required

Array<object> | null

object

convention

required

string

convention_label

string

label

required

string

magnitude

string

unit_id

required

string

key

additional properties

any

examples

required

Array<object> | null

object

after

string

before

required

string

recipe_title

required

string

source_text

required

string

key

additional properties

any

group_ids

required

Array<string> | null

required

string

ingredients

required

integer format: int64

measure_label

required

string

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_label

string

key

additional properties

any

resolution_groups

required

Array<object> | null

object

authored_form

required

string

candidate_unit_ids

required

Array<string> | null

choices

required

Array<object> | null

object

convention

required

string

convention_label

string

label

required

string

magnitude

string

unit_id

required

string

key

additional properties

any

examples

required

Array<object> | null

object

after

string

before

required

string

recipe_title

required

string

source_text

required

string

key

additional properties

any

required

string

ingredients

required

integer format: int64

kind

required

string

Allowed values: unit_alias

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_label

string

subgroups

required

Array<object> | null

object

occurrences

required

integer format: int64

>= 1

recipes

required

integer format: int64

>= 1

source_text

required

string

key

additional properties

any

key

additional properties

any

resolution_profiles

required

Array<object> | null

object

required

string

label

required

string

selects

required

Array<string> | null

unanswered

required

Array<string> | null

unit_registry_version

required

string

key

additional properties

any

key

additional properties

any

key

additional properties

any

Example

{
  "job": {
    "on_duplicate": "reject",
    "progress": {
      "diagnostics": [
        {
          "class": "blocking"
        }
      ]
    },
    "state": "pending"
  },
  "remaining": {
    "items": [
      {
        "analysis": {
          "matches": [
            {
              "evidence": "source-identity"
            }
          ],
          "status": "new"
        },
        "diagnostics": [
          {
            "class": "blocking",
            "severity": "info"
          }
        ]
      }
    ],
    "resolution_groups": [
      {
        "kind": "unit_alias"
      }
    ]
  }
}

Headers

Location

string

401

No valid session or API token (authentication-required), or the credential sent is invalid (invalid-credentials).

application/problem+json

object

code

required

string

detail

required

string

status

required

integer format: int64

title

required

string

type

required

string

key

additional properties

any

Example^generated

{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

404

Not Found

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

409

Conflict

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

413

Request Entity Too Large

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

422

Unprocessable Entity

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

500

Internal Server Error

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

503

Service Unavailable

application/problem+json

object

code

Stable application error code; clients may also use the problem type suffix.

string

detail

A human-readable explanation specific to this occurrence of the problem.

string

errors

Optional list of individual error details

Array<object> | null

object

location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string

message

Error message text

string

value

The value at the given location

key

additional properties

any

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri

params

Structured context for the stable error code.

object

key

additional properties

any

status

HTTP status code

integer format: int64

title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string

type

A URI reference to human-readable documentation for the error.

string format: uri

default: about:blank

violations

Array<object>

object

code

required

string

location

required

string

params

object

key

additional properties

any

key

additional properties

any

Example

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Start an import job

Authorizations

Parameters

Path Parameters

Header Parameters

Request Bodyrequired

Responses

202

Example

Headers

401

Examplegenerated

404

Example

409

Example

413

Example

422

Example

500

Example

503

Example

Request Body^required

Example^generated