Saved Views

Persist named filter presets for your link list

Saved views are named snapshots of link-list filter settings — folder, tag, status, search term, and date range. Once saved, a view can be recalled in one click from the dashboard sidebar or fetched via API to re-apply the same filter combination programmatically.

Tier Limits

Base URL

https://awsys.co

Authentication

All saved view endpoints require a valid API key passed as a Bearer token. See the Authentication page for details.

Authorization: Bearer YOUR_API_KEY

List Saved Views

GET /api/views

Returns up to 20 saved views ordered by creation date (newest first).

Response

{
  "views": [
    {
      "id": "view_abc123",
      "name": "Active Marketing Links",
      "filters": {
        "folderId": "folder_abc123",
        "tag": "campaign-q3",
        "status": "active",
        "search": "",
        "dateRange": "30d"
      },
      "createdAt": "2026-05-01T10:00:00Z",
      "updatedAt": "2026-05-01T10:00:00Z"
    }
  ]
}

curl example

curl https://awsys.co/api/views \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a Saved View

POST /api/views

Request body

{
  "name": "Active Marketing Links",
  "filters": {
    "folderId": "folder_abc123",
    "tag": "campaign-q3",
    "status": "active",
    "dateRange": "30d"
  }
}

Response — 201 Created

{
  "id": "view_abc123",
  "name": "Active Marketing Links",
  "filters": { "folderId": "folder_abc123", "status": "active" },
  "createdAt": "2026-05-29T12:00:00Z",
  "updatedAt": "2026-05-29T12:00:00Z"
}

curl example

curl -X POST https://awsys.co/api/views \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Active Marketing Links",
    "filters": {"folderId": "folder_abc123", "status": "active"}
  }'

Update a Saved View

PATCH /api/views/:viewId

Update the name or filters of an existing view. Only the fields you provide are changed.

Request body

{
  "name": "Active Q3 Campaigns",
  "filters": { "tag": "campaign-q3", "status": "active" }
}

Response — 200 OK

{ "success": true, "message": "View updated" }

curl example

curl -X PATCH https://awsys.co/api/views/view_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Active Q3 Campaigns"}'

Delete a Saved View

DELETE /api/views/:viewId

Response — 200 OK

{ "success": true, "message": "View deleted" }

curl example

curl -X DELETE https://awsys.co/api/views/view_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Error Codes