1. Getting started
Astravue docs
  • Getting started
    • Introduction
    • Authentication
    • Make your first request
  • General
    • Key concepts
    • Pagination and filtering
    • Errors
    • Dates and times
  • Modules
    • Spaces and projects
    • Tasks
    • Subtasks and checklists
    • Custom fields
    • Comments
    • Time tracking
    • Bulk export
  • MCP server
    • Overview
    • Get started
    • Supported tools
    • Security
    • Build your own client
Guides
API Docs
Guides
API Docs
MCP Server
Astravue MCP on GitHub
  1. Getting started

Make your first request

Every request to the Astravue API goes to the same base URL and carries two headers.

Value
Base URLhttps://api.astravue.com
AuthorizationBearer <access_token> from Authentication
X-Org-IdThe ID of the workspace you are working in

Find your workspace ID#

1
Open Astravue in your browser
Sign in at app.astravue.com and switch to the workspace you want to use.
2
Open the developer tools
Right-click the page and choose Inspect, then open the Network tab. Refresh the page if the list is empty.
3
Copy the X-Org-Id header
Click any request the page makes to the Astravue API. Under Request Headers, copy the value of X-Org-Id. That number is your workspace ID.

List your spaces#

1
Send the request
2
Read the response
Successful responses share one envelope. The records are in data:
{
  "success": true,
  "message": "...",
  "code": 200,
  "data": [
    {
      "spaceId": 1024,
      "spaceName": "Client work",
      "description": "Delivery projects for clients",
      "createdTime": "2026-09-14T09:30:00Z"
    }
  ],
  "timestamp": "2026-11-10T08:15:42Z"
}
Each space has more fields than shown here. See Get all spaces for the full list.
3
Go one level deeper
Use a spaceId to list the projects in that space, then a projectId to list its tasks.
TIP
Requests without the X-Org-Id header are refused with HTTP 400 and the message Missing X-Org-Id header.
Modified at 2026-11-10 13:09:17
Previous
Authentication
Next
Key concepts
Built with