Notes
No notes yet. Create your first note!
Categories
No categories yet. Create one to organize your notes!
Archived Notes
No archived notes.
Agent API Reference
Base URL
https://ss-notes.ocuss.app
Endpoints
/api/agent/notes
List notes with optional filtering. Returns excerpts only.
Params: workspace (required), search, tag, category_id, include_archived, limit
/api/agent/notes/{id}
Read full note content by ID.
Params: workspace (required)
/api/agent/notes
Create a new note. Author type is automatically set to "agent".
Body: { title (required), content, category_id, tags[], color }
Params: workspace (required)
/api/agent/notes/{id}
Update an existing note.
Body: { title, content, category_id, tags[], pinned, archived, color }
Params: workspace (required)
/api/agent/search
Full-text search across note titles, content, and tags.
Params: workspace (required), q (required), limit
/api/categories
List all categories with note counts.
Params: workspace (required)
/api/tags
List all unique tags with usage counts.
Params: workspace (required)
Example: Create a Note
curl -X POST "https://ss-notes.ocuss.app/api/agent/notes?workspace=ocuss" \
-H "Content-Type: application/json" \
-d '{
"title": "Meeting Notes",
"content": "## Action Items\n- Review PR\n- Deploy to staging",
"tags": ["meetings", "action-items"],
"category_id": "uuid-here"
}'
Example: Search Notes
curl "https://ss-notes.ocuss.app/api/agent/search?workspace=ocuss&q=meeting&limit=10"