Skip to main content

Saved views

Endpoints: /v1/workspaces/:workspaceId/saved-views. Auth: Bearer + x-workspace-id.

GET /v1/workspaces/:workspaceId/saved-views​

List saved views.

Response (200): Array of saved view objects (id, name, filters, isDefault, etc.).

Example:

curl -X GET https://api.inboxops.app/v1/workspaces/ws-123/saved-views \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123"

GET /v1/workspaces/:workspaceId/saved-views/:viewId​

Get one saved view.

Response (200): Saved view object.

Example:

curl -X GET https://api.inboxops.app/v1/workspaces/ws-123/saved-views/VIEW_UUID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123"

POST /v1/workspaces/:workspaceId/saved-views​

Create a saved view.

Body:

{
  "name": "My open tickets",
  "filters": {
    "status": ["open"],
    "assignee": "optional-user-id",
    "priority": "optional",
    "tags": ["tag1"],
    "mailboxId": "optional-mailbox-id-or-null"
  },
  "isDefault": false
}

Response (201): Created saved view.

Example:

curl -X POST https://api.inboxops.app/v1/workspaces/ws-123/saved-views \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123" \
  -H "Content-Type: application/json" \
  -d '{"name":"My open tickets","filters":{"status":["open"]}}'

PATCH /v1/workspaces/:workspaceId/saved-views/:viewId​

Update a saved view (name, filters, isDefault).

Body: Partial object.

Response (200): Updated saved view.

Example:

curl -X PATCH https://api.inboxops.app/v1/workspaces/ws-123/saved-views/VIEW_UUID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123" \
  -H "Content-Type: application/json" \
  -d '{"name":"Open & pending","filters":{"status":["open","pending"]}}'

DELETE /v1/workspaces/:workspaceId/saved-views/:viewId​

Delete a saved view. Returns 204 on success.

Example:

curl -X DELETE https://api.inboxops.app/v1/workspaces/ws-123/saved-views/VIEW_UUID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "x-workspace-id: ws-123"