1. General
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. General

Key concepts

Astravue organises work in a simple hierarchy. Most API paths follow it, so knowing it makes the reference easy to read.
ConceptWhat it isGuide
WorkspaceYour Astravue organisation. Every request is scoped to one workspace with the X-Org-Id header.Make your first request
SpaceA group of related projects, such as a client or a department.Spaces and projects
ProjectA body of work inside a space.Spaces and projects
Project taskA piece of work in a project.Tasks
Personal taskA task outside any project, under /v1/tasks.Tasks
SubtaskA smaller step under a task.Subtasks and checklists
ChecklistA list of check items on a task or subtask.Subtasks and checklists

What you can attach to work#

What it holdsGuide
Custom fieldsYour own data on tasks, such as a client code.Custom fields
CommentsDiscussion on a task.Comments
Time entriesTimers and logged time on tasks.Time tracking
The API acts as the signed-in user, so a request only returns what that user can see in Astravue.
Modified at 2026-11-10 17:13:01
Previous
Make your first request
Next
Pagination and filtering
Built with