projectCreate Mutation

Creates a new project.

Input Argument

projectCreate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

budgetAllocated (Boolean)

Whether the project has been approved and no longer needs to be considered for funding by portfolio management.

category (String)

The category of the project.

clientMutationId (String)

A unique identifier for the client performing the mutation.

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".

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.

customFields ([CustomFieldInput!])

Values for custom fields to be used by the UI Extension that is linked to the record.

customFieldsAttachments ([AttachmentInput!])

The attachments used in the custom fields' values.

customerId (ID!)

Identifier of 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.

justification (ProjectJustification!)

The reason why the project should be considered for implementation.

managerId (ID!)

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

newPhases ([ProjectPhaseInput!])

Phases of the project.

note (String)

High-level description of the project. It is also used to add any information that could prove useful for anyone involved in the project, including the people whose approval is needed and the people who are helping to implement it.

problemIds ([ID!])

Identifiers of the problems of the project.

program (String)

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

requestIds ([ID!])

Identifiers of the requests of the project.

riskLevel (String)

The risk level of the project.

serviceId (ID!)

Identifier of 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.

uiExtensionId (ID)

UI extension that is to be applied to the record.

value (MonetaryAmount)

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

workHoursId (ID)

Identifier of 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.

workflowIds ([ID!])

Identifiers of the workflows of the project.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

project (Project)

Record after mutation.