Upsert project

PUT

/projects/

Creates or updates a project.

Looks up an existing project by external ID. If a match is found, updates
it; otherwise creates a new project.

External ID is required.

Only the fields provided are changed; omitted fields remain unchanged.

Request

Body Params application/jsonRequired

Example

{
    "external_id": "PROJ-1001",
    "name": "Riverside Office HVAC Retrofit",
    "start_date": "2019-08-24",
    "account_customer": "80",
    "division": "66",
    "managers": [
        "65"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://app.fieldinsight.com/public-api//projects/' \
--header 'Content-Type: application/json' \
--data '{
    "external_id": "PROJ-1001",
    "name": "Riverside Office HVAC Retrofit",
    "start_date": "2019-08-24",
    "account_customer": "80",
    "division": "66",
    "managers": [
        "65"
    ]
}'

Responses

🟢200OK

application/json

Successful response.

Bodyapplication/json

Example

{
    "id": "2001"
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🟠429

Modified at 2026-10-30 03:40:11

Patch project

Remove project