Flatfile · Capability

API Reference

API Reference API capability.

Run with Naftiko FlatfileAPI

What You Can Do

GET
Get current — Get the current account
/accounts/current
PATCH
Update current — Update the current account
/accounts/current
POST
Create — Create an action
/actions
GET
Get all — Get all actions for the space
/actions
POST
Bulk create — Create several actions
/actions/bulk
GET
Get — Get an action
/actions/{actionId}
PATCH
Update — Update an action
/actions/{actionId}
DELETE
Delete — Delete an action
/actions/{actionId}
GET
List — List agent exports
/agent-exports
GET
Get — Get an agent export
/agent-exports/{agentExportId}
DELETE
Delete — Delete an agent export
/agent-exports/{agentExportId}
GET
Download — Download an agent export
/agent-exports/{agentExportId}/download
GET
List — List agents
/agents
POST
Create — Create an agent
/agents
GET
Get — Get an agent
/agents/{agentId}
DELETE
Delete — Delete an agent
/agents/{agentId}
GET
List versions — List agent versions for an agent
/agents/{agentId}/versions
GET
Revert — Revert to a specific agent version
/agents/{agentId}/versions/{agentVersionId}/revert
GET
List agent roles — List Agent Roles
/agents/{agentId}/roles
POST
Assign agent role — Assign Role to Agent
/agents/{agentId}/roles
DELETE
Delete agent role — Remove Role from Agent
/agents/{agentId}/roles/{actorRoleId}
GET
Get agent logs — Get logs for an agent
/agents/{agentId}/logs
GET
Get agent log — Get an agent log
/agents/log/{eventId}
GET
Get environment agent logs — Get all agent logs in your environment
/agents/logs
GET
Get environment agent executions — Get all executions in your environment
/agents/executions
GET
List — List apps
/apps
POST
Create — Create an app
/apps
GET
Get — Get an app
/apps/{appId}
PATCH
Update — Update an app
/apps/{appId}
DELETE
Delete — Delete an app
/apps/{appId}
GET
Get constraints — Get constraints
/apps/{appId}/constraints
POST
Create constraint — Create constraint
/apps/{appId}/constraints
GET
Get constraint by id — Get constraint by ID
/apps/{appId}/constraints/{constraintId}
PATCH
Update constraint — Update constraint
/apps/{appId}/constraints/{constraintId}
DELETE
Delete constraint — Delete constraint
/apps/{appId}/constraints/{constraintId}
GET
Get constraint versions — Get constraint versions
/apps/{appId}/constraints/{constraintId}/versions
GET
Get constraint version — Get constraint version
/apps/{appId}/constraints/{constraintId}/versions/{version}
GET
List — List prompts
//prompts
POST
Create — Create a prompt
//prompts
GET
Get — Get a prompt
//prompts/{promptId}
PATCH
Update — Update a prompt
//prompts/{promptId}
DELETE
Delete — Delete a prompts
//prompts/{promptId}
GET
Get publishable key — Obtain the publishable key for a specific environment
/auth/publishable-key
GET
Get sftp credentials — Get SFTP credentials for Space
/auth/sftp-credentials
GET
List — List canvas areas
/canvas-areas
POST
Create — Create a canvas area
/canvas-areas
GET
Get — Get a canvas area
/canvas-areas/{canvasAreaId}
PATCH
Update — Update a canvas area
/canvas-areas/{canvasAreaId}
DELETE
Delete — Delete a canvas area
/canvas-areas/{canvasAreaId}
GET
Get — Get a commit version
/commits/{commitId}
POST
Complete — Complete a commit version
/commits/{commitId}/complete
POST
Replay — Replay a commit version
/commits/{commitId}/replay
POST
Create — Create
/data-clips
GET
List — List
/data-clips
PATCH
Update — Update
/data-clips/{dataClipId}
DELETE
Delete — Delete
/data-clips/{dataClipId}
GET
Get — Get
/data-clips/{dataClipId}
POST
Add records to clip — Add Records To Clip
/data-clips/{dataClipId}/add-records
GET
Get resolutions — Get Resolutions
/data-clips/{dataClipId}/resolutions
PATCH
Update resolution — Update Resolution
/data-clips/{dataClipId}/resolutions

MCP Tools

get-current

Get the current account

read-only idempotent
update-current

Update the current account

create

Create an action

get-all

Get all actions for the space

read-only idempotent
bulk-create

Create several actions

get

Get an action

read-only idempotent
update

Update an action

delete

Delete an action

idempotent
list

List agent exports

read-only idempotent
get

Get an agent export

read-only idempotent
delete

Delete an agent export

idempotent
download

Download an agent export

read-only idempotent
list

List agents

read-only idempotent
create

Create an agent

get

Get an agent

read-only idempotent
delete

Delete an agent

idempotent
list-versions

List agent versions for an agent

read-only idempotent
revert

Revert to a specific agent version

read-only idempotent
list-agent-roles

List Agent Roles

read-only idempotent
assign-agent-role

Assign Role to Agent

delete-agent-role

Remove Role from Agent

idempotent
get-agent-logs

Get logs for an agent

read-only idempotent
get-agent-log

Get an agent log

read-only idempotent
get-environment-agent-logs

Get all agent logs in your environment

read-only idempotent
get-environment-agent-executions

Get all executions in your environment

read-only idempotent
list

List apps

read-only idempotent
create

Create an app

get

Get an app

read-only idempotent
update

Update an app

delete

Delete an app

idempotent
get-constraints

Get constraints

read-only idempotent
create-constraint

Create constraint

get-constraint-by-id

Get constraint by ID

read-only idempotent
update-constraint

Update constraint

delete-constraint

Delete constraint

idempotent
get-constraint-versions

Get constraint versions

read-only idempotent
get-constraint-version

Get constraint version

read-only idempotent
list

List prompts

read-only idempotent
create

Create a prompt

get

Get a prompt

read-only idempotent
update

Update a prompt

delete

Delete a prompts

idempotent
get-publishable-key

Obtain the publishable key for a specific environment

read-only idempotent
get-sftp-credentials

Get SFTP credentials for Space

read-only idempotent
list

List canvas areas

read-only idempotent
create

Create a canvas area

get

Get a canvas area

read-only idempotent
update

Update a canvas area

delete

Delete a canvas area

idempotent
get

Get a commit version

read-only idempotent
complete

Complete a commit version

replay

Replay a commit version

create

Create

list

List

read-only idempotent
update

Update

delete

Delete

idempotent
get

Get

read-only idempotent
add-records-to-clip

Add Records To Clip

get-resolutions

Get Resolutions

read-only idempotent
update-resolution

Update Resolution

Capability Spec

flatfile-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: API Reference
  description: API Reference API capability.
  tags:
  - Flatfile
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: flatfile
    baseUri: https://api.x.flatfile.com/v1
    description: API Reference HTTP API.
    authentication:
      type: bearer
      token: '{{FLATFILE_TOKEN}}'
    resources:
    - name: accounts-current
      path: /accounts/current
      operations:
      - name: get-current
        method: GET
        description: Get the current account
        inputParameters:
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-current
        method: PATCH
        description: Update the current account
        inputParameters:
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: actions
      path: /actions
      operations:
      - name: create
        method: POST
        description: Create an action
        inputParameters:
        - name: spaceId
          in: query
          type: string
          required: true
          description: The Space ID for which to create the Action.
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-all
        method: GET
        description: Get all actions for the space
        inputParameters:
        - name: spaceId
          in: query
          type: string
          required: true
          description: The Space ID for which to get the Actions.
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: actions-bulk
      path: /actions/bulk
      operations:
      - name: bulk-create
        method: POST
        description: Create several actions
        inputParameters:
        - name: spaceId
          in: query
          type: string
          required: true
          description: The Space ID for which to create the Actions.
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: actions-actionid
      path: /actions/{actionId}
      operations:
      - name: get
        method: GET
        description: Get an action
        inputParameters:
        - name: actionId
          in: path
          type: string
          required: true
          description: The id of the action to return
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update
        method: PATCH
        description: Update an action
        inputParameters:
        - name: actionId
          in: path
          type: string
          required: true
          description: The id of the action to patch
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete
        method: DELETE
        description: Delete an action
        inputParameters:
        - name: actionId
          in: path
          type: string
          required: true
          description: The id of the action to delete
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agent-exports
      path: /agent-exports
      operations:
      - name: list
        method: GET
        description: List agent exports
        inputParameters:
        - name: environmentId
          in: query
          type: string
        - name: agentId
          in: query
          type: string
        - name: pageSize
          in: query
          type: string
        - name: pageNumber
          in: query
          type: string
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agent-exports-agentexportid
      path: /agent-exports/{agentExportId}
      operations:
      - name: get
        method: GET
        description: Get an agent export
        inputParameters:
        - name: agentExportId
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete
        method: DELETE
        description: Delete an agent export
        inputParameters:
        - name: agentExportId
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agent-exports-agentexportid-download
      path: /agent-exports/{agentExportId}/download
      operations:
      - name: download
        method: GET
        description: Download an agent export
        inputParameters:
        - name: agentExportId
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents
      path: /agents
      operations:
      - name: list
        method: GET
        description: List agents
        inputParameters:
        - name: environmentId
          in: query
          type: string
          required: true
        - name: isSystem
          in: query
          type: boolean
        - name: search
          in: query
          type: string
        - name: pageSize
          in: query
          type: string
        - name: pageNumber
          in: query
          type: string
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create
        method: POST
        description: Create an agent
        inputParameters:
        - name: environmentId
          in: query
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid
      path: /agents/{agentId}
      operations:
      - name: get
        method: GET
        description: Get an agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
        - name: environmentId
          in: query
          type: string
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete
        method: DELETE
        description: Delete an agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
        - name: environmentId
          in: query
          type: string
          description: This environment variable is no longer needed or used
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid-versions
      path: /agents/{agentId}/versions
      operations:
      - name: list-versions
        method: GET
        description: List agent versions for an agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid-versions-agentversionid-revert
      path: /agents/{agentId}/versions/{agentVersionId}/revert
      operations:
      - name: revert
        method: GET
        description: Revert to a specific agent version
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
        - name: agentVersionId
          in: path
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid-roles
      path: /agents/{agentId}/roles
      operations:
      - name: list-agent-roles
        method: GET
        description: List Agent Roles
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
          description: The agent id
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: assign-agent-role
        method: POST
        description: Assign Role to Agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
          description: The agent id
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid-roles-actorroleid
      path: /agents/{agentId}/roles/{actorRoleId}
      operations:
      - name: delete-agent-role
        method: DELETE
        description: Remove Role from Agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
          description: The agent id
        - name: actorRoleId
          in: path
          type: string
          required: true
          description: The actor role id
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-agentid-logs
      path: /agents/{agentId}/logs
      operations:
      - name: get-agent-logs
        method: GET
        description: Get logs for an agent
        inputParameters:
        - name: agentId
          in: path
          type: string
          required: true
        - name: environmentId
          in: query
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-log-eventid
      path: /agents/log/{eventId}
      operations:
      - name: get-agent-log
        method: GET
        description: Get an agent log
        inputParameters:
        - name: eventId
          in: path
          type: string
          required: true
        - name: environmentId
          in: query
          type: string
          required: true
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-logs
      path: /agents/logs
      operations:
      - name: get-environment-agent-logs
        method: GET
        description: Get all agent logs in your environment
        inputParameters:
        - name: environmentId
          in: query
          type: string
          required: true
        - name: spaceId
          in: query
          type: string
        - name: success
          in: query
          type: string
        - name: pageSize
          in: query
          type: string
        - name: pageNumber
          in: query
          type: string
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: agents-executions
      path: /agents/executions
      operations:
      - name: get-environment-agent-executions
        method: GET
        description: Get all executions in your environment
        inputParameters:
        - name: environmentId
          in: query
          type: string
          required: true
        - name: agentId
          in: query
          type: string
        - name: spaceId
          in: query
          type: string
        - name: success
          in: query
          type: string
        - name: pageSize
          in: query
          type: string
        - name: pageNumber
          in: query
          type: string
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps
      path: /apps
      operations:
      - name: list
        method: GET
        description: List apps
        inputParameters:
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create
        method: POST
        description: Create an app
        inputParameters:
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps-appid
      path: /apps/{appId}
      operations:
      - name: get
        method: GET
        description: Get an app
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of app
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update
        method: PATCH
        description: Update an app
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of app
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete
        method: DELETE
        description: Delete an app
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of app to delete
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps-appid-constraints
      path: /apps/{appId}/constraints
      operations:
      - name: get-constraints
        method: GET
        description: Get constraints
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: includeBuiltins
          in: query
          type: boolean
          description: Whether to include built-in constraints
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-constraint
        method: POST
        description: Create constraint
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps-appid-constraints-constraintid
      path: /apps/{appId}/constraints/{constraintId}
      operations:
      - name: get-constraint-by-id
        method: GET
        description: Get constraint by ID
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: constraintId
          in: path
          type: string
          required: true
          description: ID of the constraint
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-constraint
        method: PATCH
        description: Update constraint
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: constraintId
          in: path
          type: string
          required: true
          description: ID of the constraint
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-constraint
        method: DELETE
        description: Delete constraint
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: constraintId
          in: path
          type: string
          required: true
          description: ID of the constraint
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps-appid-constraints-constraintid-versions
      path: /apps/{appId}/constraints/{constraintId}/versions
      operations:
      - name: get-constraint-versions
        method: GET
        description: Get constraint versions
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: constraintId
          in: path
          type: string
          required: true
          description: ID of the constraint
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: apps-appid-constraints-constraintid-versions-ver
      path: /apps/{appId}/constraints/{constraintId}/versions/{version}
      operations:
      - name: get-constraint-version
        method: GET
        description: Get constraint version
        inputParameters:
        - name: appId
          in: path
          type: string
          required: true
          description: ID of the app
        - name: constraintId
          in: path
          type: string
          required: true
          description: ID of the constraint
        - name: version
          in: path
          type: integer
          required: true
          description: Version of the constraint
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: prompts
      path: //prompts
      operations:
      - name: list
        method: GET
        description: List prompts
        inputParameters:
        - name: promptType
          in: query
          type: string
          description: Type of prompt (default AI_ASSIST)
        - name: pageSize
          in: query
          type: integer
          description: Number of prompts to return in a page (default 7)
        - name: pageNumber
          in: query
          type: integer
          description: Based on pageSize, which page of prompts to return
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create
        method: POST
        description: Create a prompt
        inputParameters:
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: prompts-promptid
      path: //prompts/{promptId}
      operations:
      - name: get
        method: GET
        description: Get a prompt
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
          description: ID of prompts
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update
        method: PATCH
        description: Update a prompt
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
          description: ID of prompts
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete
        method: DELETE
        description: Delete a prompts
        inputParameters:
        - name: promptId
          in: path
          type: string
          required: true
          description: ID of prompts
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: auth-publishable-key
      path: /auth/publishable-key
      operations:
      - name: get-publishable-key
        method: GET
        description: Obtain the publishable key for a specific environment
        inputParameters:
        - name: environmentId
          in: query
          type: string
          required: true
          description: ID of environment to search
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: auth-sftp-credentials
      path: /auth/sftp-credentials
      operations:
      - name: get-sftp-credentials
        method: GET
        description: Get SFTP credentials for Space
        inputParameters:
        - name: spaceId
          in: query
          type: string
          required: true
          description: ID of space to get credentials for
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-Hooks
          in: header
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: canvas-areas
      path: /canvas-areas
      operations:
      - name: list
        method: GET
        description: List canvas areas
        inputParameters:
        - name: canvasId
          in: query
          type: string
          description: ID of the canvas to filter areas by
        - name: parentId
          in: query
          type: string
          description: ID of the parent canvas area to filter by
        - name: spaceId
          in: query
          type: string
          description: ID of the space to filter areas by
        - name: environmentId
          in: query
          type: string
          description: ID of the environment to filter areas by
        - name: pageSize
          in: query
          type: integer
          description: Number of areas to return in a page (default 20)
        - name: pageNumber
          in: query
          type: integer
          description: Based on pageSize, which page of areas to return
        - name: Authorization
          in: header
          type: string
          required: true
          description: Bearer authentication
        - name: X-Disable-

# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/flatfile/refs/heads/main/capabilities/flatfile-capability.yaml