RetailHardHat Developer docs

REST API documentation

Phases

Project phases for organizing sites and tasks

Supported operations

MethodPathDescription
GET/api/v1/phasesList all phases
GET/api/v1/phases/:idGet a phase by ID
POST/api/v1/phasesCreate a new phase
PATCH/api/v1/phases/:idUpdate a phase
DELETE/api/v1/phases/:idDelete a phase

Example request

Replace YOUR_API_KEY with a private key stored in your environment. Replace path parameters with records from your organization.

curl --request GET "/api/v1/phases" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"

Field reference

Required means required by the underlying data model, not necessarily caller-supplied. The server derives protected identity and ownership fields; endpoint validation controls which fields are accepted. Sensitive credential fields are omitted here.

FieldTypeModel requirementDescription
idstringOptionalUnique identifier (auto-generated)
parentPhaseIduuidOptionalparent Phase Id

Related resource: phases

namestringRequiredname
descriptionstringOptionaldescription
colorstringOptionalcolor
startDatedatetimeOptionalstart Date
endDatedatetimeOptionalend Date
statusstringOptionalstatus
ordernumberOptionalorder
createdAtdatetimeOptionalCreation timestamp (auto)
updatedAtdatetimeOptionalLast update timestamp (auto)