Update Saved View

Use the editSavedView mutation to change a saved view’s name, icon, sharing status, or configuration. This page also covers the three related mutations that operate on existing views: updateSavedViewPosition (reorder), setWorkspaceDefaultView (set the workspace-wide default), and setUserDefaultView (set your personal default). Saved views are SavedView objects scoped to a workspace (Project).

All examples are sent to https://api.blue.app/graphql with your authentication headers (blue-token-id, blue-token-secret, blue-org-id). Header names are case-insensitive.

Request

Rename a saved view. Only the id is required; include only the fields you want to change.

mutation EditSavedView {
  editSavedView(input: { id: "view_123", name: "Q1 Roadmap" }) {
    id
    name
    updatedAt
  }
}

Parameters

EditSavedViewInput

Omitted fields are left unchanged. viewType is not part of this input and cannot be edited.

Response

editSavedView returns the full updated SavedView.

{
  "data": {
    "editSavedView": {
      "id": "clm4n8qwx000008l0g4oxdqn7",
      "name": "Q1 Roadmap",
      "updatedAt": "2026-05-29T14:02:11.000Z"
    }
  }
}

Returns

editSavedView, updateSavedViewPosition, and createSavedView all return the same SavedView! type.

Full example

Update the name, icon, sharing status, and configuration in one call. The viewConfig below uses the fields the server actually validates.

mutation EditSavedViewAdvanced {
  editSavedView(
    input: {
      id: "view_123"
      name: "Sprint Board"
      icon: "kanban"
      isShared: true
      viewConfig: {
        searchQuery: "design"
        assigneeIds: ["user_123"]
        assigneeMode: "or"
        tagIds: ["tag_123"]
        tagMode: "and"
        hiddenColumns: ["field_123"]
        pinnedColumns: { left: ["title"], right: [] }
        sort: { type: "customField", field: "field_123", direction: "asc" }
        groupBy: { type: "customField", fieldId: "field_123" }
        advancedFilters: { op: "and", conditions: [] }
      }
    }
  ) {
    id
    name
    icon
    isShared
    viewType
    viewConfig
    createdBy {
      id
      fullName
    }
    updatedAt
  }
}

viewConfig structure

viewConfig is a free-form JSON object, but the server validates known keys and rejects the whole object if any are malformed. The total payload must stay under 50 KB; string fields max 1,000 characters; arrays max 100 items.

Update view position

Use the updateSavedViewPosition mutation to reorder a view in the sidebar. It takes the view id and a new position: Float!, and returns the updated SavedView!.

mutation UpdateSavedViewPosition {
  updateSavedViewPosition(id: "view_123", position: 98302.5) {
    id
    name
    position
  }
}

{
  "data": {
    "updateSavedViewPosition": {
      "id": "clm4n8qwx000008l0g4oxdqn7",
      "name": "Sprint Board",
      "position": 98302.5
    }
  }
}

Positions are spaced by 65535 when views are created. To place a view between two others, set position to a value between theirs (a fractional value is fine). Reordering requires the same modify access as editing — see Permissions.

Set the workspace default view

Use the setWorkspaceDefaultView mutation to set a shared view as the default for everyone in the workspace. It takes a projectId: String! (ID or slug) and an optional viewId: String, and returns the updated Project! with its defaultSavedView.

mutation SetWorkspaceDefaultView {
  setWorkspaceDefaultView(projectId: "project_123", viewId: "view_123") {
    id
    name
    defaultSavedView {
      id
      name
      viewType
    }
  }
}

{
  "data": {
    "setWorkspaceDefaultView": {
      "id": "clm4n8qwx000008l0g4oxdqn7",
      "name": "Marketing",
      "defaultSavedView": {
        "id": "clm4n8qwx000009l0g4oxdqn7",
        "name": "Sprint Board",
        "viewType": "BOARD"
      }
    }
  }
}

To clear the workspace default, omit viewId or pass null:

mutation ClearWorkspaceDefaultView {
  setWorkspaceDefaultView(projectId: "project_123", viewId: null) {
    id
    defaultSavedView {
      id
    }
  }
}

Both setting and clearing require the caller to be an OWNER or ADMIN of the workspace. A MEMBER (or lower) gets PROJECT_NOT_FOUND, not FORBIDDEN — the workspace lookup is scoped to OWNER/ADMIN membership, so a member appears to have “no such project.” The target view must be shared and belong to this workspace, or the call returns FORBIDDEN.

Set your personal default view

Use the setUserDefaultView mutation to set your own default view for a workspace. It takes a projectId: String! (ID or slug) and an optional viewId: String, and returns Boolean!. The view may be personal or shared, but it must belong to the workspace. Any workspace member can set their own default.

mutation SetUserDefaultView {
  setUserDefaultView(projectId: "project_123", viewId: "view_123")
}

{ "data": { "setUserDefaultView": true } }

To clear your personal default, pass null for viewId:

mutation ClearUserDefaultView {
  setUserDefaultView(projectId: "project_123", viewId: null)
}

Passing a viewId for a view that belongs to a different workspace returns FORBIDDEN.

Errors

{
  "errors": [
    {
      "message": "You are not authorized.",
      "extensions": { "code": "FORBIDDEN" }
    }
  ]
}

Permissions

editSavedView and updateSavedViewPosition both require modify access to the view first (findModifiableSavedView):

• The creator can modify their own view (personal or shared).
• An OWNER or ADMIN can modify a view only if it is already shared.

An admin who is not the creator cannot edit a private personal view that belongs to another user — the modify-access check throws FORBIDDEN before any field-level check runs. So an admin cannot convert someone else’s personal view to shared.

Changing isShared adds a second check on top of modify access:

For the default-view mutations:

• setWorkspaceDefaultView — OWNER or ADMIN only (both setting and clearing). Others receive PROJECT_NOT_FOUND.
• setUserDefaultView — any workspace member, for their own default.

Related

• Create a saved view
• List saved views
• Delete a saved view
• List records