Astravue API
  1. Projects
Astravue API
  • Welcome to the Astravue API
  • Auth
    • Get Access and Refresh Token
      POST
    • Refresh Access Token
      POST
  • Personal Tasks
    • Get task by ID
      GET
    • Update a task
      PUT
    • Delete a task
      DELETE
    • Get all tasks
      GET
    • Create a task
      POST
  • Spaces
    • Get space by ID
      GET
    • Update a space
      PUT
    • Delete a space
      DELETE
    • Get all spaces
      GET
    • Create a new space
      POST
  • Projects
    • Get project details by ID
      GET
    • Update a project
      PUT
    • Delete a project
      DELETE
    • Get all projects in a space
      GET
    • Create a new project
      POST
  • Project Tasks
    • Get a project task by ID
      GET
    • Update a project task
      PUT
    • Delete a project task
      DELETE
    • Get all tasks in a project
      GET
    • Create a project task
      POST
  • Task Timer
    • Get timers for a user in a task
      GET
    • Get active timers for a user
      GET
    • Update a timer
      PUT
    • Stop timer for a task
      PUT
    • Delete a timer entry
      DELETE
    • Start timer for a personal task
      POST
    • Add a time range entry for a personal task
      POST
    • Add manual time entry for a personal task
      POST
    • Start timer for a project task
      POST
    • Add range timer for a project task
      POST
    • Add manual time entry for a project task
      POST
  • Task Comments
    • Get comments for a task
  • Project Subtasks
    • Get all subtasks for a project task
  • Personal Subtasks
    • Get all subtasks for a personal task
  • Tasks Checklist
    • Get all checklists for a subtask
    • Get all checklists for a parent task
  1. Projects

Create a new project

POST
https://api.astravue.com/v1/spaces/{spaceId}/projects
Creates a new project within a given space.

Request

Authorization
Add the parameter
Authorization
to Headers，whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/hal+json
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.astravue.com/v1/spaces//projects' \
--header 'X-Org-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Project Alpha",
    "description": "This is a sample project",
    "isPublic": true,
    "startDate": "2019-08-24T14:15:22Z",
    "dueDate": "2019-08-24T14:15:22Z",
    "status": "In Progress",
    "priority": "High",
    "health": "Good",
    "projectTags": [
        "tag1",
        "tag2"
    ],
    "contact": 12345
}'
Response Response Example
{
    "tenantId": 0,
    "spaceId": 0,
    "projectId": 0,
    "contact": {
        "tenantId": 0,
        "contactId": 0,
        "contactName": "string",
        "email": "string",
        "phone": {
            "countryCode": "string",
            "number": "string",
            "countryName": "string"
        },
        "mobile": {
            "countryCode": "string",
            "number": "string",
            "countryName": "string"
        },
        "address": "string",
        "city": "string",
        "country": "string",
        "state": "string",
        "zipCode": "string",
        "website": "string",
        "profilePicURL": "string",
        "profilePicName": "string",
        "profilePicColor": "string",
        "createdBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "modifiedBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "createdTime": "2019-08-24T14:15:22Z",
        "modifiedTime": "2019-08-24T14:15:22Z",
        "account": {
            "accountId": 0,
            "accountName": "string",
            "email": "string",
            "profilePicUrl": "string",
            "profilePicName": "string",
            "profilePicColor": "string"
        },
        "contactTags": [
            {
                "tenantId": 0,
                "contactTagId": 0,
                "tagName": "string",
                "color": "string",
                "createdBy": 0,
                "modifiedBy": 0
            }
        ],
        "projectCount": 0
    },
    "projectName": "string",
    "description": "string",
    "startDate": "2019-08-24T14:15:22Z",
    "dueDate": "2019-08-24T14:15:22Z",
    "completion": 0,
    "deleted": true,
    "createdTime": "2019-08-24T14:15:22Z",
    "modifiedTime": "2019-08-24T14:15:22Z",
    "deletedTime": "2019-08-24T14:15:22Z",
    "completedTime": "2019-08-24T14:15:22Z",
    "createdBy": {
        "userId": 0,
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "profilePicURL": "string",
        "profilePicName": "string",
        "profilePicColor": "string",
        "provider": "string",
        "newUser": true,
        "isTourCompleted": true,
        "about": "string",
        "updateTime": "2019-08-24T14:15:22Z",
        "expiryDate": "2019-08-24T14:15:22Z",
        "status": "string",
        "role": {
            "orgRoleId": 0,
            "roleName": "string"
        }
    },
    "modifiedBy": {
        "userId": 0,
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "profilePicURL": "string",
        "profilePicName": "string",
        "profilePicColor": "string",
        "provider": "string",
        "newUser": true,
        "isTourCompleted": true,
        "about": "string",
        "updateTime": "2019-08-24T14:15:22Z",
        "expiryDate": "2019-08-24T14:15:22Z",
        "status": "string",
        "role": {
            "orgRoleId": 0,
            "roleName": "string"
        }
    },
    "deletedBy": {
        "userId": 0,
        "firstName": "string",
        "lastName": "string",
        "email": "string",
        "profilePicURL": "string",
        "profilePicName": "string",
        "profilePicColor": "string",
        "provider": "string",
        "newUser": true,
        "isTourCompleted": true,
        "about": "string",
        "updateTime": "2019-08-24T14:15:22Z",
        "expiryDate": "2019-08-24T14:15:22Z",
        "status": "string",
        "role": {
            "orgRoleId": 0,
            "roleName": "string"
        }
    },
    "projectStatus": {
        "tenantId": 0,
        "projectStatusId": 0,
        "projectStatusName": "string",
        "color": "string",
        "projectStatusCategory": "string",
        "createdTime": "2019-08-24T14:15:22Z",
        "modifiedTime": "2019-08-24T14:15:22Z",
        "createdBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "modifiedBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "default": true
    },
    "projectPriority": {
        "tenantId": 0,
        "projectPriorityId": 0,
        "priorityLabel": "string",
        "color": "string",
        "createdBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "modifiedBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "default": true,
        "primary": true
    },
    "projectHealth": {
        "tenantId": 0,
        "projectHealthId": 0,
        "healthLabel": "string",
        "color": "string",
        "createdBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "modifiedBy": {
            "userId": 0,
            "firstName": "string",
            "lastName": "string",
            "email": "string",
            "profilePicURL": "string",
            "profilePicName": "string",
            "profilePicColor": "string",
            "provider": "string",
            "newUser": true,
            "isTourCompleted": true,
            "about": "string",
            "updateTime": "2019-08-24T14:15:22Z",
            "expiryDate": "2019-08-24T14:15:22Z",
            "status": "string",
            "role": {
                "orgRoleId": 0,
                "roleName": "string"
            }
        },
        "default": true,
        "primary": true
    },
    "projectTags": [
        {
            "tenantId": 0,
            "projectTagId": 0,
            "tagName": "string",
            "color": "string",
            "createdBy": 0,
            "modifiedBy": 0
        }
    ],
    "projectMembers": [
        {
            "projectMemberId": 0,
            "projectId": 0,
            "user": {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "string",
                "profilePicURL": "string",
                "profilePicName": "string",
                "profilePicColor": "string",
                "provider": "string",
                "newUser": true,
                "isTourCompleted": true,
                "about": "string",
                "updateTime": "2019-08-24T14:15:22Z",
                "expiryDate": "2019-08-24T14:15:22Z",
                "status": "string",
                "role": {
                    "orgRoleId": 0,
                    "roleName": "string"
                }
            },
            "invitedBy": {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "string",
                "profilePicURL": "string",
                "profilePicName": "string",
                "profilePicColor": "string",
                "provider": "string",
                "newUser": true,
                "isTourCompleted": true,
                "about": "string",
                "updateTime": "2019-08-24T14:15:22Z",
                "expiryDate": "2019-08-24T14:15:22Z",
                "status": "string",
                "role": {
                    "orgRoleId": 0,
                    "roleName": "string"
                }
            },
            "role": {
                "projectRoleId": 0,
                "projectRoleName": "string"
            }
        }
    ],
    "projectMail": "string",
    "spaceName": "string",
    "customFields": [
        {
            "tenantId": 0,
            "taskCustomFieldId": 0,
            "fieldName": "string",
            "description": "string",
            "fieldType": "string",
            "fieldValue": [
                {
                    "taskId": 0,
                    "value": {}
                }
            ],
            "fieldIcon": "string",
            "spaceId": 0,
            "projectId": 0,
            "associatedId": 0,
            "order": 0,
            "createdBy": {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "string",
                "profilePicURL": "string",
                "profilePicName": "string",
                "profilePicColor": "string",
                "provider": "string",
                "newUser": true,
                "isTourCompleted": true,
                "about": "string",
                "updateTime": "2019-08-24T14:15:22Z",
                "expiryDate": "2019-08-24T14:15:22Z",
                "status": "string",
                "role": {
                    "orgRoleId": 0,
                    "roleName": "string"
                }
            },
            "modifiedBy": {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "string",
                "profilePicURL": "string",
                "profilePicName": "string",
                "profilePicColor": "string",
                "provider": "string",
                "newUser": true,
                "isTourCompleted": true,
                "about": "string",
                "updateTime": "2019-08-24T14:15:22Z",
                "expiryDate": "2019-08-24T14:15:22Z",
                "status": "string",
                "role": {
                    "orgRoleId": 0,
                    "roleName": "string"
                }
            },
            "createdTime": "2019-08-24T14:15:22Z",
            "modifiedTime": "2019-08-24T14:15:22Z",
            "customFieldOption": [
                {
                    "optionId": 0,
                    "optionName": "string",
                    "color": "string",
                    "spaceId": 0,
                    "projectId": 0,
                    "taskCustomFieldId": 0
                }
            ]
        }
    ],
    "public": true,
    "overdue": true,
    "archived": true
}
Previous
Get all projects in a space
Next
Get a project task by ID
Built with