create

Description

Create a new project.
The current user must have access to the organization.

URL

https://api.skriv.com/1/project/create/orgId

FieldTypeDescription
orgIdintOrganization ID

GET parameters

Mandatory parameters

FieldTypeDescription
namestringProject name
descriptionstringHTML content of the project

Extended parameters

These parameters will be used only if the current user is an administrator of the organization, or if she has project management rights.

Basic extended parameters

FieldTypeDescription
categoryIdintOptional. Category ID.
templateIdintOptional. Template ID.
valueintOptional. Value.
milestoneIdintOptional. Milestone ID. 1
deadlinedateOptional. Project deadline. 1

1: If the milestoneId parameter is set, the deadline parameter is not used, and then the project deadline will be equal to the milestone deadline.

Steps definition

FieldTypeDescription
stepIdsarrayList of ID of the steps activated for this project.

For each activated step:

FieldTypeDescription
step-stepId-mandatoryboolOptional. true if the given step is mandatory. Default value: false.
deadline-step-stepIddateOptional. Deadline of the given step.
assignedRoleId-stepIdintOptional. Assigned role ID for the given step. 2
assignedUserId-stepIdintOptional. Assigned user ID for the given step. 2
validatorRoleId-stepIdintOptional. Validator role ID for the given step. 3
validatorUserId-stepIdintOptional. Validator user ID for the given step. 3

2: If the assignedRoleId-stepId parameter is set, the assignedUserId-stepId is not used.
3: If the validatorRoleId-stepId parameter is set, the validatorUserId-stepId is not used.

Stakeholders definition

FieldTypeDescription
stakeholderIdarrayList of stakeholder IDs.
stakeholderRolearrayList of associated role IDs, in the same order as the list of stakeholder IDs. Set to null if a stakeholder does not have a dedicated role (so-called Observer role).

Response

FieldTypeDescription
idintProject ID