The Projects API gives you access to the projects within your Fulcrum account. Projects can be used to separate your data into different groups for access, filtering, and exporting purposes.

Properties

Property	Type	Required	Readonly	Description
name	string	yes	no	The name of the project.
description	string	no	no	Optional project description.
id	string	no	yes	The id of the project.
created_at	string	no	yes	Timestamp when the project was created.
updated_at	string	no	yes	Timestamp when the project was last updated.

Validations

The following properties must be included in order to create/update a project object in our system. Any validation errors will return a 422 and an object with a list of validation errors.

Required Properties

Property	Type	Description	Example
name	string	The name of the project.	`"Pinellas County"`

Example validation response if name is not included:

{
  "project": {
    "errors": {
      "name": ["can't be blank"]
    }
  }
}

Notes

The entire project object is required when making an update. Omitting fields with existing data will result in data loss! The typical workflow for updating an existing project is to fetch the project object, modify it, and then submit the PUT request.

Sample Response

{
  "project": {
    "name": "Pinellas County",
    "description": "For records in Pinellas County",
    "id": "60786571-46b4-43b8-8f49-7d8f0f45987e",
    "created_at": "2013-10-29T15:49:09Z",
    "updated_at": "2014-11-18T15:23:48Z"
  }
}