Company Backups API

POST /company-backups/bootstrap/discard

Discard Company Backup During Initial Setup

Delete a company backup uploaded during first-time setup. It is closed once any user exists.

Request body

Responses

Example

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

POST /company-backups/bootstrap/import-module

Bootstrap Import Module

Parameters

Responses

Example

curl -X POST http://localhost:8000/company-backups/bootstrap/import-module \
  -H "Authorization: Bearer $TOKEN"

POST /company-backups/bootstrap/prepare

Bootstrap Prepare

Parameters

Request body

Responses

Example

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

POST /company-backups/bootstrap/read

Bootstrap Read

Parameters

Responses

Example

curl -X POST http://localhost:8000/company-backups/bootstrap/read \
  -H "Authorization: Bearer $TOKEN"

POST /company-backups/bootstrap/restore

Bootstrap Restore

Create the first owner and restore the backup as their company in one commit, then sign them in. Repeating it with the same account opens the same company.

Parameters

Request body

Responses

Example

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

GET /company-backups/bootstrap/staged

Bootstrap Staged

The upload token was issued against the setup code and names one private upload, so showing or deleting that upload needs nothing more.

Parameters

Responses

Example

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

POST /company-backups/discard

Discard Uploaded Company Backup

Delete the caller's uploaded company backup. Nothing else is touched.

Request body

Responses

Example

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

GET /company-backups/download

Download Backup

Back up the company the session is on and serve the file, deleted once sent.

Parameters

Responses

Example

curl -X GET http://localhost:8000/company-backups/download \
  -H "Authorization: Bearer $TOKEN"

POST /company-backups/import-module

Import Module for Company Backup

Install a module an uploaded company backup needs, as the Modules page does. The module is installed turned off. Send the module archive as a multipart upload with the `upload_token`.

Responses

Example

curl -X POST http://localhost:8000/company-backups/import-module \
  -H "Authorization: Bearer $TOKEN"

POST /company-backups/prepare

Prepare Modules for Company Backup

Turn on the modules an uploaded company backup needs, then restart Celerp to load them. Bundled modules are turned on. A module from outside Celerp is turned on only when it is named in `consent`.

Request body

Responses

Example

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

POST /company-backups/reactivate

Reactivate Restored Company

Reactivate the deactivated company an uploaded backup was already restored as, instead of restoring a copy, and switch the caller to it. Connectors that deactivation disconnected are named in the response and are not reconnected.

Request body

Responses

Example

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

POST /company-backups/read

Read Company Backup

Upload a company backup file and check it. The file is held privately until it is restored or discarded. Send it as a multipart upload with a `mode` of `settings` (the default) or `new_company`. The response previews what restoring does.

Responses

Example

curl -X POST http://localhost:8000/company-backups/read \
  -H "Authorization: Bearer $TOKEN"

POST /company-backups/restore

Restore Company Backup

Restore an uploaded company backup as the preview showed it, and switch the caller to the restored company. Send the `plan_fingerprint` from the preview. The request is refused if the backup or the plan changed since. Repeating a restore that finished opens the company it made.

Request body

Responses

Example

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

GET /company-backups/staged

Staged Backup

Parameters

Responses

Example

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

POST /company-backups/start-company/read

Read Company Backup for a Login With No Company

Upload a company backup file for a login that has no company left, and check it. The request carries the login's email and password as form fields with the file. The response previews what restoring does.

Responses

Example

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

POST /company-backups/start-company/restore

Restore Company Backup for a Login With No Company

Restore an uploaded company backup as the company of a login that has none left, as the preview showed it, and sign in to that company. Send the `plan_fingerprint` from the preview.

Request body

Responses

Example

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