Migrations API

POST /migrations/bootstrap/decisions

Save Bootstrap Migration Decisions

Save the choices for a scanned source on a new installation that has no user yet: the import mode, the cutover date, the answers to the scan's questions and who prepared it. Every problem is returned at once, keyed by field. It is closed for good once any user exists.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/bootstrap/decisions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/bootstrap/scan

Bootstrap Scan

Parameters

Responses

Example

curl -X POST http://localhost:8000/migrations/bootstrap/scan \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/bootstrap/scan/read

Read Bootstrap Migration Scan

Return the view of a scanned source file on a new installation that has no user yet. It is closed for good once any user exists.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/bootstrap/scan/read \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/bootstrap/start

Bootstrap Start

Create the first owner, the staged company and a preparing run in one commit, then start it (``_claim``). The bootstrap lock serializes racing starts; the loser re-checks and is refused. If the response is lost after the commit, the owner signs in and is taken back to the run. The setup code is consumed only after the commit.

Parameters

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/bootstrap/start \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/scan

Scan Migration Source

Upload a source file from another system and scan it, as a company owner. Send the file as a multipart upload. Nothing is imported at this step.

Responses

Example

curl -X POST http://localhost:8000/migrations/scan \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/scan/decisions

Save Migration Decisions

Save the choices for a scanned source: the import mode, the cutover date, the answers to the scan's questions and who prepared it. Every problem is returned at once, keyed by field.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/scan/decisions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/scan/read

Read Migration Scan

Return the view of a scanned source file. When the caller already started a migration from this scan, it returns that run's `run_id` instead, so a client whose start response was lost can return to the run.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/scan/read \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /migrations/sources

List Migration Sources

List the source systems the migration importer reads. Each source names the files it accepts, with their extensions and maximum sizes.

Responses

Example

curl -X GET http://localhost:8000/migrations/sources \
  -H "Authorization: Bearer $TOKEN"

GET /migrations/staged

Get Staged Migration Run

Return the latest migration run of the staged company the session is scoped to, which tells a client where the session belongs.

Responses

Example

curl -X GET http://localhost:8000/migrations/staged \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/start-company/decisions

Save Migration Decisions for a Login With No Company

Save the choices for a scanned source that was uploaded for a login with no company: the import mode, the cutover date, the answers to the scan's questions and who prepared it. Every problem is returned at once, keyed by field.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/start-company/decisions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/start-company/scan

Scan Migration Source for a Login With No Company

Upload a source file from another system for a login that has no company left. The request authenticates with the login's email and password as HTTP Basic credentials. Send the file as a multipart upload. Nothing is imported at this step.

Responses

Example

curl -X POST http://localhost:8000/migrations/start-company/scan \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/start-company/scan/read

Read Migration Scan for a Login With No Company

Return the view of a scanned source file that was uploaded for a login with no company.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/start-company/scan/read \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/start-company/start

Start Migration for a Login With No Company

Start a migration as the company of a login that has none left, then sign in to that company. The request carries the login's email and password, the scan token and the company name. If the login already has a company the request is refused.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/start-company/start \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

POST /migrations/start-from-scan

Start Migration From Scan

Start a migration from a scan and its saved decisions. It creates a staged company and a migration run. A repeated start from the same scan returns the run it already created.

Request body

Responses

Example

curl -X POST http://localhost:8000/migrations/start-from-scan \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /migrations/{run_id}

Get Run

Parameters

Responses

Example

curl -X GET http://localhost:8000/migrations/:run_id \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/{run_id}/cancel

Cancel Run

Parameters

Responses

Example

curl -X POST http://localhost:8000/migrations/:run_id/cancel \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/{run_id}/discard

Discard Run

Parameters

Responses

Example

curl -X POST http://localhost:8000/migrations/:run_id/discard \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/{run_id}/finalize

Finalize Run

Parameters

Request body

FinalizeIn, optional

Responses

Example

curl -X POST http://localhost:8000/migrations/:run_id/finalize \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

GET /migrations/{run_id}/posting-accounts

Get Posting Accounts

The posting accounts finishing this migration will set, and the choices for each.

Parameters

Responses

Example

curl -X GET http://localhost:8000/migrations/:run_id/posting-accounts \
  -H "Authorization: Bearer $TOKEN"

GET /migrations/{run_id}/reconciliation

Get Reconciliation

Parameters

Responses

Example

curl -X GET http://localhost:8000/migrations/:run_id/reconciliation \
  -H "Authorization: Bearer $TOKEN"

GET /migrations/{run_id}/reconciliation/pack

Get Reconciliation Pack

Parameters

Responses

Example

curl -X GET http://localhost:8000/migrations/:run_id/reconciliation/pack \
  -H "Authorization: Bearer $TOKEN"

POST /migrations/{run_id}/start

Start Run

Parameters

Responses

Example

curl -X POST http://localhost:8000/migrations/:run_id/start \
  -H "Authorization: Bearer $TOKEN"