Notes

Create, organize, and search workspace notes with agent collaboration

Health

Notes

Agent API Reference

Base URL

https://ss-notes.ocuss.app

Endpoints

GET /api/agent/notes

List notes with optional filtering. Returns excerpts only.

Params: workspace (required), search, tag, category_id, include_archived, limit

GET /api/agent/notes/{id}

Read full note content by ID.

Params: workspace (required)

POST /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)

PUT /api/agent/notes/{id}

Update an existing note.

Body: { title, content, category_id, tags[], pinned, archived, color }

Params: workspace (required)

GET /api/agent/search

Full-text search across note titles, content, and tags.

Params: workspace (required), q (required), limit

GET /api/categories

List all categories with note counts.

Params: workspace (required)

GET /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"