Project Views

4 actions. Each is callable by the agent as a tool, over HTTP via /api/invoke, and (usually) from a UI page.

`project_views.list`

GET

List a project's saved database views (table / board / roadmap / gallery / calendar).

AI tool: project_views_list
API: GET /api/invoke/project_views.list

Input

Field	Type	Required	Description
`projectId`	string	yes

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "projectId"
  ]
}

`project_views.create`

POST · mutating

Create a saved view over a project database. type: table | board | roadmap | gallery | calendar. config holds visibleFields, filters, sort, groupBy.

When the agent calls it: Use to build a saved view when the user asks to organize, group, filter, or visualize a project's records (Airtable/Notion-style). type: table | board | roadmap | gallery | calendar. config = { visibleFields: [column keys / field ids], filters: [{col,op,value}], sort: [{col,dir}], groupBy: "status" }. Add any needed columns first via project_fields.create.

AI tool: project_views_create
API: POST /api/invoke/project_views.create

Input

Field	Type	Required
`projectId`	string	yes
`name`	string	yes
`type`	string	—
`config`	object	—
`isDefault`	boolean	—
`position`	integer	—

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "projectId": {
      "type": "string",
      "minLength": 1
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "config": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "isDefault": {
      "type": "boolean"
    },
    "position": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "projectId",
    "name"
  ]
}

`project_views.update`

PATCH · mutating

Update a saved view — name, type, or config (columns/filters/sort/group).

AI tool: project_views_update
API: PATCH /api/invoke/project_views.update

Input

Field	Type	Required	Description
`id`	string	yes
`patch`	object	yes

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    },
    "patch": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "type": {
          "type": "string"
        },
        "config": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "isDefault": {
          "type": "boolean"
        },
        "position": {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        }
      }
    }
  },
  "required": [
    "id",
    "patch"
  ]
}

`project_views.delete`

DELETE · mutating

Delete a saved view.

AI tool: project_views_delete
API: DELETE /api/invoke/project_views.delete

Input

Field	Type	Required	Description
`id`	string	yes

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id"
  ]
}