> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowengineering.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fire one of an agent's manual triggers by hand

> Starts a side chat with the agent, as the agent, with the trigger's prompt, on the branch named and about the items picked. Editors and admins who can see the agent may run it. The bot authors the turn, using the caller's current project permissions.



## OpenAPI

````yaml /openapi/customer-api.json post /project/{projectId}/agents/{agentId}/triggers/{triggerId}/fire
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Flow customer API reference. Start with the [quickstart](/api/quickstart)
    and [authentication guide](/api/authentication).
  title: Customer API
  version: 1.0.0
servers:
  - description: Flow API
    url: '{baseUrl}'
    variables:
      baseUrl:
        default: https://backend.branch.flowengineering.com
security: []
tags:
  - name: Audit
  - name: Automations
  - name: Branches
  - name: Comments
  - name: Convert
  - name: Data Model
  - name: Diagrams
  - name: Entities
  - name: Events
  - name: Files
  - name: Import
  - name: Notifications
  - name: Persistent agents
  - name: Projects
  - name: ReqIF
  - name: ReqIF Import
  - name: Review policy
  - name: Shared Access Grants
  - name: User Groups
  - name: Users
paths:
  /project/{projectId}/agents/{agentId}/triggers/{triggerId}/fire:
    post:
      tags:
        - Persistent agents
      summary: Fire one of an agent's manual triggers by hand
      description: >-
        Starts a side chat with the agent, as the agent, with the trigger's
        prompt, on the branch named and about the items picked. Editors and
        admins who can see the agent may run it. The bot authors the turn, using
        the caller's current project permissions.
      operationId: AgentDefinitionsController_fire
      parameters:
        - in: path
          name: projectId
          required: true
          schema:
            type: string
        - in: path
          name: agentId
          required: true
          schema:
            type: string
        - in: path
          name: triggerId
          required: true
          schema:
            type: string
        - description: Workspace identifier
          in: header
          name: customer
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FireAgentTriggerDto'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentTriggerFiredDto'
          description: ''
      security:
        - api-key: []
        - bearer: []
components:
  schemas:
    FireAgentTriggerDto:
      properties:
        branchId:
          description: 'The branch the agent works on: a branch''s id, or Base''s.'
          type: string
        entityIds:
          description: >-
            The items the agent is launched on, if any: ids of items in the
            project.
          items:
            type: string
          type: array
      type: object
    AgentTriggerFiredDto:
      properties:
        chatId:
          description: The side chat the firing started.
          type: string
      required:
        - chatId
      type: object
  securitySchemes:
    api-key:
      in: header
      name: X-API-Key
      type: apiKey
    bearer:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.