Project Object

Root Connection

All Project objects of an account are accessible by a query on the root connection projects. Such a query will return a ProjectConnection!, which contains the Project objects in its nodes field.

projects (ProjectConnection!)

Root connection for retrieving Project records.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

filter ProjectFilter

Filter to determine which Project records are returned.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

order [ProjectOrder!]

Order of the Project records returned.

view ProjectView

View name.

The default value is current_account.

Fields

The fields in this section list which values can be retrieved when querying Project records.

account (Account)

The account this record belongs to.

category (String)

The category of the project.

completedAt (ISO8601Timestamp)

Automatically set to the date and time at which the project is saved with the status "Completed".

completionReason (ProjectCompletionReason)

The appropriate completion reason for the project when it has been completed. It is automatically set to "Complete" when all tasks related to the project have reached the status "Completed", "Approved" or "Canceled".

completionTargetAt (ISO8601Timestamp)

The target date and time of the last task of the project.

costOfEffort (MonetaryAmount)

The estimated cost of the effort that will be needed from internal employees and/or long-term contractors to implement the project.

costOfPurchases (MonetaryAmount)

The estimated cost of all purchases (for equipment, consulting effort, licenses, etc.) needed to implement the project. Recurring costs that will be incurred following the implementation of the project are to be included for the entire ROI calculation period.

createdAt (ISO8601Timestamp)

The date and time at which the record was created.

customFields ([CustomField!])

Values of custom fields.

customer (Organization)

Used to select the organization for which the project is to be implemented.

effort (Int)

The estimated number of hours of effort that will be needed from internal employees and/or long-term contractors to implement the project.

id (ID!)

Unique identifier of the object.

justification (ProjectJustification)

The reason why the project should be considered for implementation.

lifeCycleState (LifeCycleState)

Current state of the record.

manager (Person)

The person who is responsible for coordinating the implementation of the project.

program (String)

Used to indicate which program the project is a part of.

projectId (String)

The record ID as displayed in the UI

riskLevel (String)

The risk level of the project.

roi (Int)

The estimated return on investment for the project. This percentage is calculated by dividing the value, minus the total costs, by the total costs and multiplying the result by 100.

service (Service)

The service for which the project will be implemented.

source (String)

An identifier for the client application submitting the resource or the name of an external system

sourceID (String)

The unique identifier of the resource in an external system

status (ProjectStatus)

Automatically set based on the status of the project's tasks.

subject (String)

A short description of the objective of the project.

timeZone (TimeZone)

The time zone that applies to the selected work hours.

totalCost (MonetaryAmount)

The total estimated cost to implement the project. This is the sum of the estimated cost of effort and cost of purchases.

uiExtension (UiExtension)

UI extension that is linked to the record.

updatedAt (ISO8601Timestamp)

The date and time of the last update of the record. If the record has no updates it contains the createdAt value.

value (MonetaryAmount)

The estimated financial value that the implementation of the project will deliver for the entire ROI calculation period.

workHours (Calendar)

The calendar that defines the work hours that are to be used to calculate the anticipated assignment and completion target for the tasks of the project.

Connections

The connection fields in this section allow (paged) access to objects related to a specific Project record. The actual objects will be in the nodes field of the connection.

changes (ChangeConnection)

Changes of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

customFieldsAttachments (AttachmentConnection)

Inline images linked to one of the custom fields.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

invoices (InvoiceConnection)

Invoices associated with this object.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

notes (NoteConnection)

Notes of the record.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

phases (ProjectPhaseConnection)

Phases of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

problems (ProblemConnection)

Problems of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

requests (RequestConnection)

Requests of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

risks (RiskConnection)

Risks of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

tasks (ProjectTaskConnection)

Tasks of the project.

Argument Type Description
after String

Returns the elements in the list that come after the specified cursor.

before String

Returns the elements in the list that come before the specified cursor.

first Int

Returns the first n elements from the list.

last Int

Returns the last n elements from the list.

Implements

Project implements the following interfaces. This means that fragments defined on these interfaces may be used in queries returning a Project.