Skip to main content
Use the REST API for services in any language and integrations that do not need local folder discovery.

​
Base URL

https://almanac-backend-83vc.onrender.com
All product routes begin with /v1 and require HTTPS.

​
Make a first authenticated request

export ALMANAC_API_URL="https://almanac-backend-83vc.onrender.com"
export ALMANAC_TOKEN="waka_..."

curl "$ALMANAC_API_URL/v1/me" \
  -H "Authorization: Bearer $ALMANAC_TOKEN"
Create the key and choose permissions in API keys.

​
Discover IDs

Direct API path parameters such as {workspace_id}, {wiki_id}, {job_id}, and {source_id} require resource IDs—not handles or slugs. 
curl "$ALMANAC_API_URL/v1/workspaces" \
  -H "Authorization: Bearer $ALMANAC_TOKEN"

curl "$ALMANAC_API_URL/v1/wikis?workspace_id=$WORKSPACE_ID" \
  -H "Authorization: Bearer $ALMANAC_TOKEN"

​
Search the wiki

curl --get "$ALMANAC_API_URL/v1/wikis/$WIKI_ID/search" \
  -H "Authorization: Bearer $ALMANAC_TOKEN" \
  --data-urlencode "q=customer onboarding"
Search results include a folder-aware page path, title, summary, excerpt, and relevance rank.

Handle errors and pages

Use the stable error envelope, request IDs, limits, and offsets.

Browse endpoints

Open the generated request and response reference.