Projects

Create a new project

Changed on

Creates a new project within a given space.

post/v1/spaces/{spaceId}/projects

Request

  • Base URL
    https://api.astravue.com
  • URL
    https://api.astravue.com/v1/spaces/{spaceId}/projects
  • Auth
    none declared. Required headers: X-Org-Id

Path parameters

spaceIdinteger required

ID of the space

Headers

X-Org-Idinteger required

Organization ID

Request body

namestring required

Name of the project

descriptionstring

Description of the project

isPublicboolean

Indicates if the project is public

startDatestring date-time

Start date of the project

dueDatestring date-time

Due date of the project

statusstring

Status of the project

prioritystring

Priority of the project

healthstring

Health of the project

projectTagsstring[]

List of tags associated with the project

contactinteger

Contact ID associated with the project

actualStartDatestring date-time

Actual start date of the project

actualEndDatestring date-time

Actual end date of the project

allocatedBudgetnumber double

Budget allocated for the project

billableCostnumber double

Billable cost of the project so far

nonBillableCostnumber double

Non-billable cost of the project so far

actualCostnumber double

Actual cost of the project (billable + non-billable)

projectTypestring

Commercial model of the project. One of FIXED_FEE, TIME_AND_MATERIAL, RETAINER. Nullable for legacy/undecided projects.

contractValuenumber double

Contract value for Fixed Fee projects (client-facing amount). Required semantically when projectType=FIXED_FEE.

alertThresholdPercentinteger

Percentage of contract or NTE cap consumed at which the project is flagged AT_RISK. 1..100. Shared by FIXED_FEE (dollars) and TIME_AND_MATERIAL (hours).

nteCapHoursinteger

Not-to-exceed cap in milliseconds for Time & Material projects (matches actualHours unit). Required semantically when projectType=TIME_AND_MATERIAL.

retainerBudgetPeriodstring

Retainer budget period. One of MONTHLY, QUARTERLY, ANNUALLY. Required semantically when projectType=RETAINER.

retainerBudgetedHoursinteger

Per-cycle hour budget in milliseconds for Retainer projects (matches actualHours unit). Required semantically when projectType=RETAINER.

retainerFeenumber double

Per-cycle retainer fee in USD (base currency; converted at read). Required semantically when projectType=RETAINER.

retainerCountHoursModestring

Which time entries count toward the retainer hour bucket. One of BOTH, BILLABLE_ONLY, NON_BILLABLE_ONLY. Defaults to BOTH.

retainerCountCostModestring

Which time entries count toward the retainer cost total. One of BOTH, BILLABLE_ONLY, NON_BILLABLE_ONLY. Defaults to BOTH.

retainerCycleAnchorstring date

First day of the first retainer cycle in yyyy-MM-dd format. Falls back to project startDate, then createdTime, then today.

Example request

{
  "name": "Project Alpha",
  "description": "This is a sample project",
  "isPublic": true,
  "startDate": "2023-01-01",
  "dueDate": "2023-12-31",
  "status": "In Progress",
  "priority": "High",
  "health": "Good",
  "projectTags": [
    "tag1",
    "tag2"
  ],
  "contact": 12345,
  "actualStartDate": "2023-01-05",
  "actualEndDate": "2023-12-15",
  "allocatedBudget": 500000,
  "billableCost": 200000,
  "nonBillableCost": 50000,
  "actualCost": 250000,
  "projectType": "FIXED_FEE",
  "contractValue": 45000,
  "alertThresholdPercent": 80,
  "nteCapHours": 720000000,
  "retainerBudgetPeriod": "MONTHLY",
  "retainerBudgetedHours": 540000000,
  "retainerFee": 8000,
  "retainerCountHoursMode": "BOTH",
  "retainerCountCostMode": "BOTH",
  "retainerCycleAnchor": "2024-01-01"
}

Response

OK

Changes

  • 2e610947dac4Revision changes
    • warning

      removed the request property

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 237f5bbd4029Revision changes
    • breaking

      removed the media type application/hal+json for the response with the status

    • info

      added the media type application/vnd.hal+json for the response with the status