Astravue API
  1. Personal Tasks
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
  • Notifications and Mentions
    • Get all notifications and mentions
    • Mark notification/mentions as read
    • Delete multiple notifications
  1. Personal Tasks

Create a task

POST
https://api.astravue.com/v1/tasks
Create a new task
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.astravue.com/v1/tasks' \
--header 'X-Org-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "taskTitle": "Implement authentication module",
    "description": "This task involves implementing the authentication module for the application.",
    "owners": [
        1,
        2,
        3
    ],
    "startDate": "2023-10-01T00:00:00Z",
    "dueDate": "2023-10-15T00:00:00Z",
    "completion": 50,
    "status": "In Progress",
    "priority": "High",
    "tags": [
        "backend",
        "urgent"
    ]
}'
Response Response Example
{
    "success": true,
    "message": "Operation completed successfully",
    "code": 200,
    "data": {
        "tenantId": 0,
        "taskId": 0,
        "taskTitle": "string",
        "description": "string",
        "descriptionMentionedUserIds": [
            0
        ],
        "startDate": "2019-08-24T14:15:22Z",
        "dueDate": "2019-08-24T14:15:22Z",
        "completion": 0,
        "priority": {
            "tenantId": 0,
            "taskPriorityId": 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
        },
        "status": {
            "tenantId": 0,
            "taskStatusId": 0,
            "statusName": "string",
            "color": "string",
            "statusCategory": "string",
            "projectId": 0,
            "spaceId": 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"
                }
            },
            "default": true,
            "primary": true
        },
        "taskTags": [
            {
                "tenantId": 0,
                "taskTagId": 0,
                "tagName": "string",
                "color": "string",
                "createdBy": 0,
                "modifiedBy": 0
            }
        ],
        "overdueStatus": true,
        "parentId": 0,
        "taskListId": 0,
        "createdByMail": "string",
        "senderName": "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"
            }
        },
        "modifiedTime": "2019-08-24T14:15:22Z",
        "createdTime": "2019-08-24T14:15:22Z",
        "deleted": true,
        "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"
            }
        },
        "deletedTime": "2019-08-24T14:15:22Z",
        "completedTime": "2019-08-24T14:15:22Z",
        "timer": 0,
        "messageId": "string",
        "owners": [
            {
                "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"
                }
            }
        ],
        "followers": [
            {
                "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"
                }
            }
        ],
        "taggedUsers": [
            {
                "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"
                }
            }
        ],
        "members": [
            {
                "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"
                }
            }
        ],
        "projectId": 0,
        "spaceId": 0,
        "projectName": "string",
        "spaceName": "string",
        "subTaskCount": 0,
        "parentCommentCount": 0,
        "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
                    }
                ]
            }
        ],
        "blockedByTasks": [
            {
                "tenantId": 0,
                "dependencyId": 0,
                "spaceId": 0,
                "projectId": 0,
                "dependencyType": "string",
                "blocking": {
                    "taskId": 0,
                    "projectId": 0,
                    "spaceId": 0,
                    "taskTitle": "string",
                    "status": {
                        "tenantId": 0,
                        "taskStatusId": 0,
                        "statusName": "string",
                        "color": "string",
                        "statusCategory": "string",
                        "projectId": 0,
                        "spaceId": 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"
                            }
                        },
                        "default": true,
                        "primary": true
                    },
                    "dueDate": "2019-08-24T14:15:22Z",
                    "owners": [
                        {
                            "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"
                            }
                        }
                    ]
                },
                "blockedBy": {
                    "taskId": 0,
                    "projectId": 0,
                    "spaceId": 0,
                    "taskTitle": "string",
                    "status": {
                        "tenantId": 0,
                        "taskStatusId": 0,
                        "statusName": "string",
                        "color": "string",
                        "statusCategory": "string",
                        "projectId": 0,
                        "spaceId": 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"
                            }
                        },
                        "default": true,
                        "primary": true
                    },
                    "dueDate": "2019-08-24T14:15:22Z",
                    "owners": [
                        {
                            "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"
                            }
                        }
                    ]
                },
                "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"
                    }
                },
                "createdTime": "2019-08-24T14:15:22Z"
            }
        ],
        "blockingTasks": [
            {
                "tenantId": 0,
                "dependencyId": 0,
                "spaceId": 0,
                "projectId": 0,
                "dependencyType": "string",
                "blocking": {
                    "taskId": 0,
                    "projectId": 0,
                    "spaceId": 0,
                    "taskTitle": "string",
                    "status": {
                        "tenantId": 0,
                        "taskStatusId": 0,
                        "statusName": "string",
                        "color": "string",
                        "statusCategory": "string",
                        "projectId": 0,
                        "spaceId": 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"
                            }
                        },
                        "default": true,
                        "primary": true
                    },
                    "dueDate": "2019-08-24T14:15:22Z",
                    "owners": [
                        {
                            "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"
                            }
                        }
                    ]
                },
                "blockedBy": {
                    "taskId": 0,
                    "projectId": 0,
                    "spaceId": 0,
                    "taskTitle": "string",
                    "status": {
                        "tenantId": 0,
                        "taskStatusId": 0,
                        "statusName": "string",
                        "color": "string",
                        "statusCategory": "string",
                        "projectId": 0,
                        "spaceId": 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"
                            }
                        },
                        "default": true,
                        "primary": true
                    },
                    "dueDate": "2019-08-24T14:15:22Z",
                    "owners": [
                        {
                            "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"
                            }
                        }
                    ]
                },
                "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"
                    }
                },
                "createdTime": "2019-08-24T14:15:22Z"
            }
        ],
        "parent": true,
        "internal": true,
        "recurring": true
    },
    "timestamp": "2023-01-01T12:00:00Z"
}

Request

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

Body Params application/json

Examples

Responses

🟢200OK
application/hal+json
Task created successfully
Body

Previous
Get all tasks
Next
Get space by ID
Built with