sam/pi-config
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

project-ops: note Outline 502 flakiness + direct .13:3000 workaround

Browse Source
This commit is contained in:
Sam Rolfe
2026-09-06 10:12:00 +10:00
parent 956db72719
commit b0b55a1489
1 changed files with 6 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
skills/project-ops/SKILL.md
View File

@@ -67,6 +67,8 @@ curl -s -X POST "$BASE/tasks/<task_id>" -H "Authorization: Bearer $VIKUNJA_TOKEN
Base: `https://outline.lab.audasmedia.com.au/api` Base: `https://outline.lab.audasmedia.com.au/api`
Same bearer pattern (`Authorization: Bearer $OL_API_KEY`, `Content-Type: application/json`). Endpoints are **POST**. 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 ```bash
# collections (top-level doc groups) # collections (top-level doc groups)
curl -s -X POST "$OL_BASE/collections.list" -H "Authorization: Bearer $OL_API_KEY" \ 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 # search docs
curl -s -X POST "$OL_BASE/documents.search" -H "Authorization: Bearer $OL_API_KEY" \ curl -s -X POST "$OL_BASE/documents.search" -H "Authorization: Bearer $OL_API_KEY" \
-H "Content-Type: application/json" -d '{"query":"<search terms>","limit":10}' -H "Content-Type: application/json" -d '{"query":"<search terms>","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":"<id>","title":"<T>","text":"<md>","publish":true}'
``` ```
## 4. Guidance ## 4. Guidance