Kibana · Capability

Kibana APIs — agent builder

Kibana APIs — agent builder. 37 operations. Lead operation: Send A2A task. Self-contained Naftiko capability covering one Kibana business surface.

Run with Naftiko Kibanaagent builder

What You Can Do

POST
Postagentbuildera2aagentid — Send A2A task
/v1/api/agent-builder/a2a/{agentid}
GET
Getagentbuildera2aagentidjson — Get A2A agent card
/v1/api/agent-builder/a2a/agentid-json
GET
Getagentbuilderagents — List agents
/v1/api/agent-builder/agents
POST
Postagentbuilderagents — Create an agent
/v1/api/agent-builder/agents
POST
Postagentbuilderagentsagentidconsumption — Get agent consumption data
/v1/api/agent-builder/agents/{agent-id}/consumption
DELETE
Deleteagentbuilderagentsid — Delete an agent
/v1/api/agent-builder/agents/{id}
GET
Getagentbuilderagentsid — Get an agent by ID
/v1/api/agent-builder/agents/{id}
PUT
Putagentbuilderagentsid — Update an agent
/v1/api/agent-builder/agents/{id}
GET
Getagentbuilderconversations — List conversations
/v1/api/agent-builder/conversations
DELETE
Deleteagentbuilderconversationsconversationid — Delete conversation by ID
/v1/api/agent-builder/conversations/{conversation-id}
GET
Getagentbuilderconversationsconversationid — Get conversation by ID
/v1/api/agent-builder/conversations/{conversation-id}
GET
Getagentbuilderconversationsconversationidattachments — List conversation attachments
/v1/api/agent-builder/conversations/{conversation-id}/attachments
POST
Postagentbuilderconversationsconversationidattachments — Create conversation attachment
/v1/api/agent-builder/conversations/{conversation-id}/attachments
GET
Getagentbuilderconversationsconversationidattachmentsstale — Check attachment staleness
/v1/api/agent-builder/conversations/{conversation-id}/attachments/stale
DELETE
Deleteagentbuilderconversationsconversationidattachmentsattachmentid — Delete conversation attachment
/v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}
PATCH
Patchagentbuilderconversationsconversationidattachmentsattachmentid — Rename attachment
/v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}
PUT
Putagentbuilderconversationsconversationidattachmentsattachmentid — Update conversation attachment
/v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}
POST
Postagentbuilderconversationsconversationidattachmentsattachmentidrestore — Restore deleted attachment
/v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}/restore
PUT
Putagentbuilderconversationsconversationidattachmentsattachmentidorigin — Update attachment origin
/v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}/origin
POST
Postagentbuilderconverse — Send chat message
/v1/api/agent-builder/converse
POST
Postagentbuilderconverseasync — Send chat message (streaming)
/v1/api/agent-builder/converse/async
POST
Postagentbuildermcp — MCP server
/v1/api/agent-builder/mcp
GET
Getagentbuilderplugins — List plugins
/v1/api/agent-builder/plugins
POST
Postagentbuilderpluginsinstall — Install a plugin
/v1/api/agent-builder/plugins/install
DELETE
Deleteagentbuilderpluginspluginid — Delete a plugin
/v1/api/agent-builder/plugins/{pluginid}
GET
Getagentbuilderpluginspluginid — Get a plugin by id
/v1/api/agent-builder/plugins/{pluginid}
GET
Getagentbuilderskills — List skills
/v1/api/agent-builder/skills
POST
Postagentbuilderskills — Create a skill
/v1/api/agent-builder/skills
DELETE
Deleteagentbuilderskillsskillid — Delete a skill
/v1/api/agent-builder/skills/{skillid}
GET
Getagentbuilderskillsskillid — Get a skill by id
/v1/api/agent-builder/skills/{skillid}
PUT
Putagentbuilderskillsskillid — Update a skill
/v1/api/agent-builder/skills/{skillid}
GET
Getagentbuildertools — List tools
/v1/api/agent-builder/tools
POST
Postagentbuildertools — Create a tool
/v1/api/agent-builder/tools
POST
Postagentbuildertoolsexecute — Run a tool
/v1/api/agent-builder/tools/execute
DELETE
Deleteagentbuildertoolstoolid — Delete a tool
/v1/api/agent-builder/tools/{toolid}
GET
Getagentbuildertoolstoolid — Get a tool by id
/v1/api/agent-builder/tools/{toolid}
PUT
Putagentbuildertoolstoolid — Update a tool
/v1/api/agent-builder/tools/{toolid}

MCP Tools

send-a2a-task

Send A2A task

get-a2a-agent-card

Get A2A agent card

read-only idempotent
list-agents

List agents

read-only idempotent
create-agent

Create an agent

get-agent-consumption-data

Get agent consumption data

read-only
delete-agent

Delete an agent

idempotent
get-agent-id

Get an agent by ID

read-only idempotent
update-agent

Update an agent

idempotent
list-conversations

List conversations

read-only idempotent
delete-conversation-id

Delete conversation by ID

idempotent
get-conversation-id

Get conversation by ID

read-only idempotent
list-conversation-attachments

List conversation attachments

read-only idempotent
create-conversation-attachment

Create conversation attachment

check-attachment-staleness

Check attachment staleness

read-only idempotent
delete-conversation-attachment

Delete conversation attachment

idempotent
rename-attachment

Rename attachment

idempotent
update-conversation-attachment

Update conversation attachment

idempotent
restore-deleted-attachment

Restore deleted attachment

update-attachment-origin

Update attachment origin

idempotent
send-chat-message

Send chat message

send-chat-message-streaming

Send chat message (streaming)

mcp-server

MCP server

list-plugins

List plugins

read-only idempotent
install-plugin

Install a plugin

delete-plugin

Delete a plugin

idempotent
get-plugin-id

Get a plugin by id

read-only idempotent
list-skills

List skills

read-only idempotent
create-skill

Create a skill

delete-skill

Delete a skill

idempotent
get-skill-id

Get a skill by id

read-only idempotent
update-skill

Update a skill

idempotent
list-tools

List tools

read-only idempotent
create-tool

Create a tool

run-tool

Run a tool

delete-tool

Delete a tool

idempotent
get-tool-id

Get a tool by id

read-only idempotent
update-tool

Update a tool

idempotent

Capability Spec

kibana-agent-builder.yaml Raw ↑
naftiko: 1.0.0-alpha2
info:
  label: Kibana APIs — agent builder
  description: 'Kibana APIs — agent builder. 37 operations. Lead operation: Send A2A task. Self-contained Naftiko capability
    covering one Kibana business surface.'
  tags:
  - Kibana
  - agent builder
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    KIBANA_API_KEY: KIBANA_API_KEY
capability:
  consumes:
  - type: http
    namespace: kibana-agent-builder
    baseUri: https://{kibana_url}
    description: Kibana APIs — agent builder business capability. Self-contained, no shared references.
    resources:
    - name: api-agent_builder-a2a-agentId
      path: /api/agent_builder/a2a/{agentId}
      operations:
      - name: postagentbuildera2aagentid
        method: POST
        description: Send A2A task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: agentId
          in: path
          type: string
          description: The unique identifier of the agent to send the A2A task to.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-a2a-agentId}.json
      path: /api/agent_builder/a2a/{agentId}.json
      operations:
      - name: getagentbuildera2aagentidjson
        method: GET
        description: Get A2A agent card
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: agentId
          in: path
          type: string
          description: The unique identifier of the agent to get A2A metadata for.
          required: true
    - name: api-agent_builder-agents
      path: /api/agent_builder/agents
      operations:
      - name: getagentbuilderagents
        method: GET
        description: List agents
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postagentbuilderagents
        method: POST
        description: Create an agent
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-agents-agent_id-consumption
      path: /api/agent_builder/agents/{agent_id}/consumption
      operations:
      - name: postagentbuilderagentsagentidconsumption
        method: POST
        description: Get agent consumption data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: agent_id
          in: path
          type: string
          description: The unique identifier of the agent.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-agents-id
      path: /api/agent_builder/agents/{id}
      operations:
      - name: deleteagentbuilderagentsid
        method: DELETE
        description: Delete an agent
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: id
          in: path
          type: string
          description: The unique identifier of the agent to delete.
          required: true
      - name: getagentbuilderagentsid
        method: GET
        description: Get an agent by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The unique identifier of the agent to retrieve.
          required: true
      - name: putagentbuilderagentsid
        method: PUT
        description: Update an agent
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: id
          in: path
          type: string
          description: The unique identifier of the agent to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-conversations
      path: /api/agent_builder/conversations
      operations:
      - name: getagentbuilderconversations
        method: GET
        description: List conversations
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: agent_id
          in: query
          type: string
          description: Optional agent ID to filter conversations by a specific agent.
    - name: api-agent_builder-conversations-conversation_id
      path: /api/agent_builder/conversations/{conversation_id}
      operations:
      - name: deleteagentbuilderconversationsconversationid
        method: DELETE
        description: Delete conversation by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation to delete.
          required: true
      - name: getagentbuilderconversationsconversationid
        method: GET
        description: Get conversation by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation to retrieve.
          required: true
    - name: api-agent_builder-conversations-conversation_id-attachments
      path: /api/agent_builder/conversations/{conversation_id}/attachments
      operations:
      - name: getagentbuilderconversationsconversationidattachments
        method: GET
        description: List conversation attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: include_deleted
          in: query
          type: boolean
          description: Whether to include deleted attachments in the list.
      - name: postagentbuilderconversationsconversationidattachments
        method: POST
        description: Create conversation attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-conversations-conversation_id-attachments-stale
      path: /api/agent_builder/conversations/{conversation_id}/attachments/stale
      operations:
      - name: getagentbuilderconversationsconversationidattachmentsstale
        method: GET
        description: Check attachment staleness
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
    - name: api-agent_builder-conversations-conversation_id-attachments-attachment_id
      path: /api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}
      operations:
      - name: deleteagentbuilderconversationsconversationidattachmentsattachmentid
        method: DELETE
        description: Delete conversation attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: attachment_id
          in: path
          type: string
          description: The unique identifier of the attachment to delete.
          required: true
        - name: permanent
          in: query
          type: boolean
          description: If true, permanently removes the attachment (only for unreferenced attachments).
      - name: patchagentbuilderconversationsconversationidattachmentsattachmentid
        method: PATCH
        description: Rename attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: attachment_id
          in: path
          type: string
          description: The unique identifier of the attachment to rename.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: putagentbuilderconversationsconversationidattachmentsattachmentid
        method: PUT
        description: Update conversation attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: attachment_id
          in: path
          type: string
          description: The unique identifier of the attachment to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-conversations-conversation_id-attachments-attachment_id-_resto
      path: /api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/_restore
      operations:
      - name: postagentbuilderconversationsconversationidattachmentsattachmentidrestore
        method: POST
        description: Restore deleted attachment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: attachment_id
          in: path
          type: string
          description: The unique identifier of the attachment to restore.
          required: true
    - name: api-agent_builder-conversations-conversation_id-attachments-attachment_id-origin
      path: /api/agent_builder/conversations/{conversation_id}/attachments/{attachment_id}/origin
      operations:
      - name: putagentbuilderconversationsconversationidattachmentsattachmentidorigin
        method: PUT
        description: Update attachment origin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: conversation_id
          in: path
          type: string
          description: The unique identifier of the conversation.
          required: true
        - name: attachment_id
          in: path
          type: string
          description: The unique identifier of the attachment to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-converse
      path: /api/agent_builder/converse
      operations:
      - name: postagentbuilderconverse
        method: POST
        description: Send chat message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-converse-async
      path: /api/agent_builder/converse/async
      operations:
      - name: postagentbuilderconverseasync
        method: POST
        description: Send chat message (streaming)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-mcp
      path: /api/agent_builder/mcp
      operations:
      - name: postagentbuildermcp
        method: POST
        description: MCP server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: namespace
          in: query
          type: string
          description: Comma-separated list of namespaces to filter tools. Only tools matching the specified namespaces will
            be returned.
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-plugins
      path: /api/agent_builder/plugins
      operations:
      - name: getagentbuilderplugins
        method: GET
        description: List plugins
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-agent_builder-plugins-install
      path: /api/agent_builder/plugins/install
      operations:
      - name: postagentbuilderpluginsinstall
        method: POST
        description: Install a plugin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-plugins-pluginId
      path: /api/agent_builder/plugins/{pluginId}
      operations:
      - name: deleteagentbuilderpluginspluginid
        method: DELETE
        description: Delete a plugin
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: pluginId
          in: path
          type: string
          description: The unique identifier of the plugin.
          required: true
        - name: force
          in: query
          type: boolean
          description: If true, removes the plugin skills from agents that use them and then deletes the plugin. If false
            and any agent uses the plugin skills, the request returns 409
      - name: getagentbuilderpluginspluginid
        method: GET
        description: Get a plugin by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pluginId
          in: path
          type: string
          description: The unique identifier of the plugin.
          required: true
    - name: api-agent_builder-skills
      path: /api/agent_builder/skills
      operations:
      - name: getagentbuilderskills
        method: GET
        description: List skills
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: include_plugins
          in: query
          type: boolean
          description: Set to true to include skills from plugins.
      - name: postagentbuilderskills
        method: POST
        description: Create a skill
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-skills-skillId
      path: /api/agent_builder/skills/{skillId}
      operations:
      - name: deleteagentbuilderskillsskillid
        method: DELETE
        description: Delete a skill
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: skillId
          in: path
          type: string
          description: The unique identifier of the skill.
          required: true
        - name: force
          in: query
          type: boolean
          description: If true, removes the skill from agents that use it and then deletes it. If false and any agent uses
            the skill, the request returns 409 Conflict with the list of
      - name: getagentbuilderskillsskillid
        method: GET
        description: Get a skill by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: skillId
          in: path
          type: string
          description: The unique identifier of the skill.
          required: true
      - name: putagentbuilderskillsskillid
        method: PUT
        description: Update a skill
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: skillId
          in: path
          type: string
          description: The unique identifier of the skill.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-tools
      path: /api/agent_builder/tools
      operations:
      - name: getagentbuildertools
        method: GET
        description: List tools
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postagentbuildertools
        method: POST
        description: Create a tool
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-tools-_execute
      path: /api/agent_builder/tools/_execute
      operations:
      - name: postagentbuildertoolsexecute
        method: POST
        description: Run a tool
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-agent_builder-tools-toolId
      path: /api/agent_builder/tools/{toolId}
      operations:
      - name: deleteagentbuildertoolstoolid
        method: DELETE
        description: Delete a tool
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: toolId
          in: path
          type: string
          description: The unique identifier of the tool to delete.
          required: true
        - name: force
          in: query
          type: boolean
          description: If true, removes the tool from agents that use it and then deletes it. If false and any agent uses
            the tool, the request returns 409 Conflict with the list of a
      - name: getagentbuildertoolstoolid
        method: GET
        description: Get a tool by id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: toolId
          in: path
          type: string
          description: The unique identifier of the tool to retrieve.
          required: true
      - name: putagentbuildertoolstoolid
        method: PUT
        description: Update a tool
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: kbn-xsrf
          in: header
          type: string
          description: A required header to protect against CSRF attacks
          required: true
        - name: toolId
          in: path
          type: string
          description: The unique identifier of the tool to update.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.KIBANA_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: kibana-agent-builder-rest
    port: 8080
    description: REST adapter for Kibana APIs — agent builder. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/agent-builder/a2a/{agentid}
      name: api-agent-builder-a2a-agentid
      description: REST surface for api-agent_builder-a2a-agentId.
      operations:
      - method: POST
        name: postagentbuildera2aagentid
        description: Send A2A task
        call: kibana-agent-builder.postagentbuildera2aagentid
        with:
          agentId: rest.agentId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/a2a/agentid-json
      name: api-agent-builder-a2a-agentid-json
      description: REST surface for api-agent_builder-a2a-agentId}.json.
      operations:
      - method: GET
        name: getagentbuildera2aagentidjson
        description: Get A2A agent card
        call: kibana-agent-builder.getagentbuildera2aagentidjson
        with:
          agentId: rest.agentId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/agents
      name: api-agent-builder-agents
      description: REST surface for api-agent_builder-agents.
      operations:
      - method: GET
        name: getagentbuilderagents
        description: List agents
        call: kibana-agent-builder.getagentbuilderagents
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postagentbuilderagents
        description: Create an agent
        call: kibana-agent-builder.postagentbuilderagents
        with:
          kbn-xsrf: rest.kbn-xsrf
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/agents/{agent-id}/consumption
      name: api-agent-builder-agents-agent-id-consumption
      description: REST surface for api-agent_builder-agents-agent_id-consumption.
      operations:
      - method: POST
        name: postagentbuilderagentsagentidconsumption
        description: Get agent consumption data
        call: kibana-agent-builder.postagentbuilderagentsagentidconsumption
        with:
          kbn-xsrf: rest.kbn-xsrf
          agent_id: rest.agent_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/agents/{id}
      name: api-agent-builder-agents-id
      description: REST surface for api-agent_builder-agents-id.
      operations:
      - method: DELETE
        name: deleteagentbuilderagentsid
        description: Delete an agent
        call: kibana-agent-builder.deleteagentbuilderagentsid
        with:
          kbn-xsrf: rest.kbn-xsrf
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getagentbuilderagentsid
        description: Get an agent by ID
        call: kibana-agent-builder.getagentbuilderagentsid
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: putagentbuilderagentsid
        description: Update an agent
        call: kibana-agent-builder.putagentbuilderagentsid
        with:
          kbn-xsrf: rest.kbn-xsrf
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/conversations
      name: api-agent-builder-conversations
      description: REST surface for api-agent_builder-conversations.
      operations:
      - method: GET
        name: getagentbuilderconversations
        description: List conversations
        call: kibana-agent-builder.getagentbuilderconversations
        with:
          agent_id: rest.agent_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/conversations/{conversation-id}
      name: api-agent-builder-conversations-conversation-id
      description: REST surface for api-agent_builder-conversations-conversation_id.
      operations:
      - method: DELETE
        name: deleteagentbuilderconversationsconversationid
        description: Delete conversation by ID
        call: kibana-agent-builder.deleteagentbuilderconversationsconversationid
        with:
          kbn-xsrf: rest.kbn-xsrf
          conversation_id: rest.conversation_id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getagentbuilderconversationsconversationid
        description: Get conversation by ID
        call: kibana-agent-builder.getagentbuilderconversationsconversationid
        with:
          conversation_id: rest.conversation_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/conversations/{conversation-id}/attachments
      name: api-agent-builder-conversations-conversation-id-attachments
      description: REST surface for api-agent_builder-conversations-conversation_id-attachments.
      operations:
      - method: GET
        name: getagentbuilderconversationsconversationidattachments
        description: List conversation attachments
        call: kibana-agent-builder.getagentbuilderconversationsconversationidattachments
        with:
          conversation_id: rest.conversation_id
          include_deleted: rest.include_deleted
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postagentbuilderconversationsconversationidattachments
        description: Create conversation attachment
        call: kibana-agent-builder.postagentbuilderconversationsconversationidattachments
        with:
          kbn-xsrf: rest.kbn-xsrf
          conversation_id: rest.conversation_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/conversations/{conversation-id}/attachments/stale
      name: api-agent-builder-conversations-conversation-id-attachments-stale
      description: REST surface for api-agent_builder-conversations-conversation_id-attachments-stale.
      operations:
      - method: GET
        name: getagentbuilderconversationsconversationidattachmentsstale
        description: Check attachment staleness
        call: kibana-agent-builder.getagentbuilderconversationsconversationidattachmentsstale
        with:
          conversation_id: rest.conversation_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/agent-builder/conversations/{conversation-id}/attachments/{attachment-id}
      name: api-agent-builder-conversations-conversation-id-attachments-attachment-id
      description: REST surface for api-agent_builder-conversations-conversation_id-attachments-attachment_id.
      operations:
      - method: DELETE
        name: deleteagentbuilderconversationsconversationidattachmentsattachmentid
        description: Delete conversation attachment
        call: kibana-agent-builder.deleteagentbuilderconversationsconversationidattachmentsattachmentid
        with:
          kbn-xsrf: rest.kbn-xsrf
          conversation_id: rest.conversation_id
          attachment_id: rest

# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kibana/refs/heads/main/capabilities/kibana-agent-builder.yaml