Axisdream
Join waitlist
OverviewPlatformREST APIPython SDKTypeScript SDKMCPSpaces and data

REST API

Canonical HTTP routes for direct integration with Axisdream.

The REST API is the source of truth for direct integrations.

SDKs and MCP use the same public routes and tool names.

Use REST when you need direct HTTP control. For normal AI connections, the SDK or MCP setup is simpler.

Canonical space routes

MethodPathMeaning
POST
/spaces/{space_id}/retrieve
Find relevant context
GET
/spaces/{space_id}/fetch?path=...
Open one or more known files exactly
GET
/spaces/{space_id}/list?folder=...
Browse files and folders
GET
/spaces/{space_id}/skills
List available procedural skills
GET
/spaces/{space_id}/skills/fetch?path=...
Open a known skill file exactly
POST
/spaces/{space_id}/add
Create or replace a file
POST
/spaces/{space_id}/update
Apply a targeted edit
DELETE
/spaces/{space_id}/forget?path=...
Delete a file from the space
POST
/spaces/{space_id}/knowledge/confidence
Adjust a file confidence score
GET
/spaces/{space_id}/knowledge/related?path=...
See directly related files

How to use the verbs

  • retrieve when you need help finding the right file.
  • fetch when you already know the exact file path.
  • list when you want to see structure and available folders.
  • add when you are writing a complete new file.
  • update when you only need a small edit.
  • forget when a file should be removed from the space.

Examples

Find context
curl -X POST "$AXISDREAM_BASE_URL/spaces/my-space/retrieve" \
  -H "Authorization: Bearer $AXISDREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"release checklist","query_variants":[{"query":"release checklist planning","kind":"rewrite"},{"query":"a passage about a release checklist","kind":"hyde"},{"query":"release checklist ship confidence","kind":"exact"}]}'
Read a file
curl "$AXISDREAM_BASE_URL/spaces/my-space/fetch?path=state/mission.md" \
  -H "Authorization: Bearer $AXISDREAM_API_KEY"
Create a file
curl -X POST "$AXISDREAM_BASE_URL/spaces/my-space/add" \
  -H "Authorization: Bearer $AXISDREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"path":"knowledge/retry.md","content":"# Retry\nUse exponential backoff.","bucket":"knowledge","topic":"retry"}'