---
title: "Create an arbo document"
method: POST
path: "/public/arbo-document/v1/create-arbo-document"
tags: ["Arbo document"]
---

# Create an arbo document

`POST /public/arbo-document/v1/create-arbo-document`

Create an arbo document

## Request body

- ArboDocumentCreationRequestV1
  - `companyId` string, uuid, required — The unique id of the client company.
  - `contactId` string, uuid, required — The unique id of the client company's contact person on whose behalf this API is called.
  - `workerPointOfContactContactId` string, uuid, required — The unique id of the client company's contact person that acts as the point of contact for the worker. Their phone number will be shared with the worker.
  - `date` string, date, required — The date, that is considered to be the date of drafting the arbo document. In ISO 8601 calendar date (YYYY-MM-DD). TODO: check whether there are any restrictions on the date.
  - `functionId` string, uuid, required — The function applicable to the activities for the work that this arbo document is valid for (arbo documents cannot apply to more than one function). The id must be a value returned from the collective-labour-agreement API. The function's collective labour agreement must be one of the client company's collective labour agreements.
  - `isDocumentForSafetyEducation` boolean, required — `true` if there is a document with general safety-related information material, `false` otherwise. The caller of this endpoint should make that document available together with the created arbo document.
  - `isDocumentForSpecificSafetyRegulations` boolean, required — `true` if there is a document with client-company safety precautions for this arbo document's function, `false` otherwise. The caller of this endpoint should make that document available together with the created arbo document.
  - `isDocumentForInHouseEmergencyServiceAgreements` boolean, required — `true` if there is a document with client-company arrangements for emergency response, `false` otherwise. The caller of this endpoint should make that document available together with the created arbo document.
  - `isSafetyProtectedEquipment` boolean, required — `true` if the worker needs equipment for safety protection, `false` otherwise. If true, it is mandatory for the client company to provide that equipment (in a timely manner).
  - `isWorkOnThirdPartyLocations` boolean, required — `true` if the worker will work at third-party locations (i.e. locations not belonging to the client company). If true, the client company is responsible for providing any necessary information about safety and health regulations at those locations.

## Response `200`

Successfully created the arbo document

- ArboDocumentV1
  - `fileId` string, uuid, required — The unique id of the arbo document PDF.

## Other responses

- `400` — The request could not be processed. This could be due to a number of reasons: * The request does not have all required data. * Data in the request is invalid. * Data in the request is inconsistent. * The operation is not allowed given the current state of the data.
- `401` — The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403` — The data that the request referred to is inaccessible to the caller.

---

[API](https://skmtc.net/maqqie/apis/maqqie-public-api.md) · [All operations](https://skmtc.net/maqqie/apis/maqqie-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maqqie/maqqie-public-api/revisions/87ac62a48f6e/schema)