v1

latestOpenAPI 3.0.32026-07-246304082.0 MB

tasks

Create a new task

post/api/v3/projects/{project_id}/tasks

Path parameters

project_idstring uuid required

ID of the project this entity belongs to

Headers

Fieldwire-Versionstring date required

Specifies the version of the API to talk to

Request body

idstring uuid

ID of the entity

creator_user_idinteger required

ID of the user who created this entity

last_editor_user_idinteger

ID of the user who most recently edited this entity

owner_user_idinteger required

ID of the user who owns the entity

floorplan_idstring uuid nullable

ID of the floorplan the entity belongs to

location_idstring uuid nullable

ID of the location the entity belongs to

team_idstring uuid nullable

ID of the team the entity belongs to

is_localboolean

Indicates if task is positioned on floorplan

namestring nullable

Name of the entity

due_datestring date nullable

Date when task is to be completed by

cost_valuenumber double nullable

Monetary cost associated with the Task

man_power_valuenumber double nullable

Numeric value representing estimated time in Man-power hours/day/month

pos_xinteger nullable

Horizontal pixels (from left of floorplan) of task pin's point

pos_yinteger nullable

Vertical pixels (from top of floorplan) of task pin's point

pos_zinteger nullable

Z coordinate of a task

priorityinteger required

Priority of the task (1, 2, 3)

device_created_atstring date-time

Time when the device created the entity

device_updated_atstring date-time

Time when the device last updated the entity

due_atstring date-time nullable

Datetime of when the Task is due

end_atstring date-time nullable

Time when this task is marked as ending

fixed_atstring date-time nullable

Datetime of when the Task is fixed

start_atstring date-time nullable

Datetime of when the Task is to start

verified_atstring date-time nullable

Time when task was verified

status_idstring uuid nullable

Entity ID linking to the Status of the Task

user_idsinteger[] nullable

All User IDs associated with this Task

task_type_idstring uuid nullable

ID of the TaskType of the Task

Response

Successful response

idstring uuid required

ID of the entity

creator_user_idinteger required

ID of the user who created this entity

last_editor_user_idinteger required

ID of the user who most recently edited this entity

owner_user_idinteger required

ID of the user who owns the entity

floorplan_idstring uuid nullable

ID of the floorplan the entity belongs to

location_idstring uuid nullable

ID of the location the entity belongs to

project_idstring uuid required

ID of the project this entity belongs to

team_idstring uuid nullable

ID of the team the entity belongs to

is_localboolean required

Indicates if task is positioned on floorplan

is_privateboolean required

A Boolean value indicating if Task is private to User

namestring nullable

Name of the entity

due_datestring date nullable

Date when task is to be completed by

cost_valuenumber double nullable

Monetary cost associated with the Task

man_power_valuenumber double nullable

Numeric value representing estimated time in Man-power hours/day/month

pos_xinteger nullable

Horizontal pixels (from left of floorplan) of task pin's point

pos_yinteger nullable

Vertical pixels (from top of floorplan) of task pin's point

pos_zinteger nullable

Z coordinate of a task

priorityinteger required

Priority of the task (1, 2, 3)

sequence_numberinteger nullable

Unique sequential identifier of task on project

created_atstring date-time required

Time when the server created the entity

deleted_atstring date-time nullable

Time the server deleted the entity

device_created_atstring date-time required

Time when the device created the entity

device_updated_atstring date-time required

Time when the device last updated the entity

due_atstring date-time nullable

Datetime of when the Task is due

end_atstring date-time nullable

Time when this task is marked as ending

fixed_atstring date-time nullable

Datetime of when the Task is fixed

start_atstring date-time nullable

Datetime of when the Task is to start

updated_atstring date-time required

Time when the server last updated the entity

verified_atstring date-time nullable

Time when task was verified

resolved_conflictboolean nullable required

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

status_idstring uuid nullable

Entity ID linking to the Status of the Task

user_idsinteger[] nullable

All User IDs associated with this Task

task_type_idstring uuid nullable

ID of the TaskType of the Task

latest_component_device_updated_atstring date-time nullable required

Time when the device last updated a component associated to the entity (bubble, check item, tag or CTA)