From b0b55a1489dbda1a6c1b6fe2cf9e33ecfa02ce89 Mon Sep 17 00:00:00 2001 From: Sam Rolfe Date: Sun, 6 Sep 2026 10:12:00 +1000 Subject: [PATCH] project-ops: note Outline 502 flakiness + direct .13:3000 workaround --- skills/project-ops/SKILL.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/skills/project-ops/SKILL.md b/skills/project-ops/SKILL.md index 0efef62..ccdee63 100644 --- a/skills/project-ops/SKILL.md +++ b/skills/project-ops/SKILL.md @@ -67,6 +67,8 @@ curl -s -X POST "$BASE/tasks/" -H "Authorization: Bearer $VIKUNJA_TOKEN Base: `https://outline.lab.audasmedia.com.au/api` Same bearer pattern (`Authorization: Bearer $OL_API_KEY`, `Content-Type: application/json`). Endpoints are **POST**. +> ⚠️ **Known flakiness:** the public (Caddy) endpoint intermittently returns **502** on writes/reads. If you get a 502, **retry once** (often transient). For reliable create/update (e.g. `documents.create`), go **directly to the container**: `POST http://127.0.0.1:3000/api/...` from `.13` (same key). + ```bash # collections (top-level doc groups) curl -s -X POST "$OL_BASE/collections.list" -H "Authorization: Bearer $OL_API_KEY" \ @@ -79,6 +81,10 @@ curl -s -X POST "$OL_BASE/documents.list" -H "Authorization: Bearer $OL_API_KEY" # search docs curl -s -X POST "$OL_BASE/documents.search" -H "Authorization: Bearer $OL_API_KEY" \ -H "Content-Type: application/json" -d '{"query":"","limit":10}' + +# reliable direct create (on .13): +curl -s -X POST "http://127.0.0.1:3000/api/documents.create" -H "Authorization: Bearer $OL_API_KEY" \ + -H "Content-Type: application/json" -d '{"collectionId":"","title":"","text":"","publish":true}' ``` ## 4. Guidance