Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-2691084.8 KB

Creates or update a project

Save a project in Jarvi. It creates the project if it does not exist, updates it if it does.

post/rest/v2/projects

Request body

projectIdstring

The id of the project you want to update.

namestring

The name of the project you want to update/create.

externalIdstring

The id of the project you want to update in your system.

isMadeForRecruitmentboolean

Whether the project is made for recruitment, and should be displayed in the ATS

isMadeForSalesboolean

Whether the project is made for sales, and should be displayed in the CRM

createdAtstring

The date of creation of the project

assigneesstring

The assignees of the project

statusIdstring

The status of the project

companyIdstring

The company of the project

colorIdstring

The color of the project

customFieldsValuesobject

Custom fields values for the project. The key should be the field ID and the value can be any text value.

Example request

{
  "projectId": "713a8005-e54d-4ee3-b6a4-89b27167dde6",
  "name": "Dev JAVA - IDF",
  "externalId": "123456",
  "isMadeForRecruitment": true,
  "isMadeForSales": true,
  "createdAt": "2024-01-01T00:00:00.000Z",
  "assignees": "Sarah Le Roué, Johan Barri, Quentin DECRE",
  "statusId": "dbab8773-8b59-4597-af75-b31333dd5409",
  "companyId": "df587e25-03e6-4b9a-aaa4-c9c20a913f4d",
  "colorId": "#d81b60",
  "customFieldsValues": {
    "00da911c-e3e1-46c1-86cc-0c1ec53e3213": "<p>Custom field content</p>",
    "de7fae4a-5f73-43a4-a92f-e19c4ecd81f1": "true",
    "8f4e7a2b-c9d1-45e6-b3a2-f8e9c7d6b5a4": "Angular, React, Vue"
  }
}

Response

The application has been saved

messagestring
taskIdstring
projectIdstring

Example response

{
  "message": "Project saved successfully",
  "taskId": "0b538428-7652-4243-baaf-3867803d7007",
  "projectId": "d730cca9-d8b0-49e7-b2e0-c58c1bb7af9f"
}