Endpoint Overview

# Endpoint Overview

All endpoints are prefixed with `/api/v1`. Authentication via Bearer token is required unless noted.

| Category        | Method | Endpoint                       | Auth    | Description                   |
|:----------------|:-------|:-------------------------------|:--------|:------------------------------|
| Identity        | GET    | `/api/v1/me`                   | Required| Current user profile & quota  |
| Search          | GET    | `/api/v1/search?q={query}`     | Required| Unified search across domains |
| Notifications   | GET    | `/api/v1/notifications`        | Required| User notifications            |
| Nodes — List    | GET    | `/api/v1/nodes`                | Required| List nodes (sort, page)       |
| Nodes — Detail  | GET    | `/api/v1/nodes/{id}`           | Required| Get node (optional `?nv=N`)   |
| Nodes — Create  | POST   | `/api/v1/nodes`                | Required| Create a new node             |
| Nodes — Update  | PUT    | `/api/v1/nodes/{id}`           | Required| Update a node                 |
| Nodes — Delete  | POST   | `/api/v1/nodes/{id}/delete`    | Required| Delete a node                 |
| Flows — List    | GET    | `/api/v1/flows`                | Required| List flows (sort, page)       |
| Flows — Detail  | GET    | `/api/v1/flows/{id}`           | Required| Get flow (optional `?fv=N`)   |
| Flows — Create  | POST   | `/api/v1/flows`                | Required| Create a new flow             |
| Flows — Update  | POST   | `/api/v1/flows/{id}`           | Required| Update a flow                 |
| Flows — Delete  | POST   | `/api/v1/flows/{id}/delete`    | Required| Delete a flow                 |
| Hubs — List     | GET    | `/api/v1/hubs`                 | Required| List hubs (filter param)      |
| Hubs — Detail   | GET    | `/api/v1/hubs/{slug}`          | Required| Get hub by slug               |
| Hubs — Create   | POST   | `/api/v1/hubs`                 | Required| Create a new hub              |
| Hubs — Update   | POST   | `/api/v1/hubs/{id}`            | Required| Update a hub                  |
| Hubs — Delete   | POST   | `/api/v1/hubs/{id}/delete`     | Required| Delete a hub                  |
| Posts — List    | GET    | `/api/v1/hubs/{id}/posts`      | Required| List posts in a hub           |
| Posts — My      | GET    | `/api/v1/hubs/my/posts`        | Required| All my posts across hubs      |
| Posts — Detail  | GET    | `/api/v1/hubs/posts/{id}`      | Required| Get a specific post           |
| Posts — Create  | POST   | `/api/v1/hubs/{id}/posts`      | Required| Create a post in a hub        |
| Posts — Update  | POST   | `/api/v1/hubs/posts/{id}`      | Required| Update a post                 |
| Posts — Delete  | POST   | `/api/v1/hubs/posts/{id}/delete`| Required| Delete a post                |
| Bulk            | POST   | `/api/v1/bulk`                 | Required| Batch operations              |

// COMMENTS

ON THIS PAGE