naftiko: 1.0.0-alpha2
info:
  label: Filevine Tasks API — Tasks
  description: 'Filevine Tasks — list, create, and update assignable to-do items on a project, with status, priority, and due dates.'
  tags:
  - Filevine
  - Tasks
  - Legal
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    FILEVINE_BEARER: FILEVINE_BEARER
capability:
  consumes:
  - type: http
    namespace: tasks-tasks
    baseUri: https://api.filevine.io
    description: Filevine tasks surface.
    resources:
    - name: project-tasks
      path: /core/projects/{projectId}/tasks
      operations:
      - name: listProjectTasks
        method: GET
        description: List tasks on a project.
        inputParameters:
        - name: projectId
          in: path
          type: integer
          required: true
      - name: createTask
        method: POST
        description: Create a task on a project.
        inputParameters:
        - name: projectId
          in: path
          type: integer
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: tasks-id
      path: /core/tasks/{taskId}
      operations:
      - name: updateTask
        method: PATCH
        description: Update a task.
        inputParameters:
        - name: taskId
          in: path
          type: integer
          required: true
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: 'Bearer {{env.FILEVINE_BEARER}}'
      placement: header
  exposes:
  - type: mcp
    namespace: tasks-tasks-mcp
    port: 9090
    transport: http
    description: MCP adapter for Filevine tasks.
    tools:
    - name: filevine-list-project-tasks
      description: List tasks on a Filevine project.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: tasks-tasks.listProjectTasks
      with:
        projectId: tools.projectId
    - name: filevine-create-task
      description: Create a task on a Filevine project.
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: tasks-tasks.createTask
      with:
        projectId: tools.projectId
        body: tools.body
    - name: filevine-update-task
      description: Update a Filevine task.
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: tasks-tasks.updateTask
      with:
        taskId: tools.taskId
        body: tools.body