v1

latestOpenAPI 3.0.32026-07-246304082.0 MB

projects

Update a project

patch/api/v3/projects/{id}

Path parameters

idstring uuid required

ID of the entity

Headers

Fieldwire-Versionstring date required

Specifies the version of the API to talk to

Request body

has_logoboolean

Boolean if project has logo

is_mobile_location_creation_enabledboolean nullable

If location creation on mobile is enabled for this project

is_email_notifications_enabledboolean

Whether email notifications are enabled for this project

prompt_effort_on_completeboolean

Whether prompt to input effort should be shown on marking tasks as completed

addressstring nullable

Address of this project

codestring nullable

Code of this project

colorstring

Color to use for this project for highlighting in the UI

currencystring

Currency to use for the cost_value of Tasks in this project

logo_urlstring nullable

URL of the logo for this project

man_power_unitsstring

Unit to use for the man_power_value of Tasks in this project

namestring

Name of this project

min_verified_at_daysinteger

Count of days after which verified tasks are archived

sheets_limitinteger nullable

Count of the latest sheet versions that should be cached on the mobile apps

archived_atstring date-time nullable

Time when this project was archived

device_updated_atstring date-time

Time when the device last updated the entity

is_photo_attachments_enabledboolean

Whether Photos tab should be shown for this project

is_plan_email_notifications_enabledboolean

Whether notifications should be sent out on processing plans

is_tasks_enabledboolean

Whether Tasks tab should be shown for this project

Timezone of this project

measurement_units'imperial' | 'metric'

Unit to use for the measurements show on plans

box_syncboolean

Set to true if you have a box token ID and want to use it for this project

dropbox_syncboolean

Set to true if you have a Dropbox token ID and want to use it for this project

box_token_user_idinteger

ID of a user who has an active valid Box token, to be used for this newly created project

dropbox_token_user_idinteger

ID of a user who has an active valid Dropbox token, to be used for this newly created project

Response

Successful response

idstring uuid required

ID of the entity

account_idinteger required

Account id project is under

has_logoboolean required

Boolean if project has logo

is_3d_bim_enabledboolean nullable

If 3D BIM is enabled for this project

is_mobile_location_creation_enabledboolean nullable

If location creation on mobile is enabled for this project

is_email_notifications_enabledboolean required

Whether email notifications are enabled for this project

is_plan_text_search_enabledboolean

Whether plan text search is enabled for this project

prompt_effort_on_completeboolean required

Whether prompt to input effort should be shown on marking tasks as completed

addressstring nullable

Address of this project

codestring nullable

Code of this project

colorstring required

Color to use for this project for highlighting in the UI

currencystring required

Currency to use for the cost_value of Tasks in this project

default_pm_group_idstring uuid nullable

The default PmGroup for this project, if it is a PM-enabled project

logo_urlstring nullable

URL of the logo for this project

man_power_unitsstring required

Unit to use for the man_power_value of Tasks in this project

namestring required

Name of this project

time_zonestring required

Timezone of this project

min_verified_at_daysinteger

Count of days after which verified tasks are archived

sheets_limitinteger nullable

Count of the latest sheet versions that should be cached on the mobile apps

owner_emailstring nullable

Email of user who owns the project

plan_name'Basic' | 'Pro' | 'Business' | 'Enterprise'

Tier this project belongs to

is_premiumboolean required

If this is a premium project

is_enterpriseboolean required

If this project is an enterprise project

work_weekboolean[] nullable

Array of seven boolean values indicating whether Sunday-Saturday are work days

archived_atstring date-time nullable

Time when this project was archived

created_atstring date-time required

Time when the server created the entity

device_created_atstring date-time required

Time when the device created the entity

resolved_conflictboolean required

Specifies if PUT/PATCH request was rejected - do not store this field!

device_updated_atstring date-time required

Time when the device last updated the entity

updated_atstring date-time required

Time when the server last updated the entity

deleted_atstring date-time nullable

Time the server deleted the entity

is_analytics_enabledboolean

Whether analytics is enabled for this project

is_forms_enabledboolean

Whether Forms tab should be shown for this project

is_photo_attachments_enabledboolean

Whether Photos tab should be shown for this project

is_plan_email_notifications_enabledboolean

Whether notifications should be sent out on processing plans

is_tasks_enabledboolean

Whether Tasks tab should be shown for this project

Timezone of this project

measurement_units'imperial' | 'metric'

Unit to use for the measurements show on plans

trial_end_atstring date-time nullable

Time when the trial for this project ends

is_task_status_enabledboolean nullable

Whether this project can have custom task statuses (denoted by Status)

min_api_versionstring date nullable

Minimum Fieldwire API version required to use this project

pm_group_idstring uuid nullable

Id of PM Group for user of this project

is_project_labels_enabledboolean

Whether Project Labels should be shown for this project