List views

Returns the views on a project, ordered by when they were created. A view is a saved grouping of the project’s rows. Chart groupings are not included.

Request

string

required

Bearer token for a workspace API key scoped to this workspace.

string

required

Workspace slug.

integer

required

Project ID.

curl "https://app.askgrapple.com/api/v1/workspaces/acme-corp/projects/42/views" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

array

Views on the project.

Show view object

integer

View ID. Pass this as {view} when you fetch the view or its rows.

string

View name.

integer | null

ID of the parent view when this view is nested. null for a top-level view.

{
  "data": [
    {
      "id": 117,
      "name": "Last name",
      "parent_id": null
    },
    {
      "id": 118,
      "name": "Last name by month",
      "parent_id": 117
    }
  ]
}

Errors

Status	Reason
`401`	Missing or invalid API key
`403`	API key does not belong to this workspace
`404`	Project not found in this workspace

Getting Started

Data Library

Projects

API

Admin

Request

Response

Errors

​Request

​Response

​Errors

Request

Response

Errors