Astravue API
  1. Spaces
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. Spaces

Create a new space

POST
https://api.astravue.com/v1/spaces
Creates a new space for the current tenant.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.astravue.com/v1/spaces' \
--header 'X-Org-Id: 1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spaceName": "Project Management Space",
    "description": "This space is for managing project tasks",
    "spaceType": "Public_To_All"
}'
Response Response Example
{
    "success": true,
    "message": "Operation completed successfully",
    "code": 200,
    "data": {
        "tenantId": 0,
        "spaceId": 0,
        "spaceName": "string",
        "description": "string",
        "color": "string",
        "spaceType": "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",
        "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",
        "spaceMembers": [
            {
                "spaceMemberId": 0,
                "spaceId": 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"
                    }
                },
                "spaceRole": {
                    "spaceRoleId": 0,
                    "spaceRoleName": "string"
                },
                "joined": true,
                "hidden": true
            }
        ],
        "projectAdminMatch": true,
        "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
                    }
                ]
            }
        ],
        "archived": 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
OK
Body

Previous
Get all spaces
Next
Get project details by ID
Built with