> ## Documentation Index > Fetch the complete documentation index at: https://test-8862363a-tembo-docs-commit-attribution-preference.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Update an agent trigger > Update an agent trigger configuration or enabled state. ## OpenAPI ````yaml https://api.tembo.io/public-api/openapi/public patch /v1/agents/{agentId}/triggers/{triggerId} openapi: 3.1.0 info: title: Tembo Public API description: >- Manage agents, sessions, repositories, and organization resources with the Tembo API. version: 1.0.0 servers: - url: https://api.tembo.io description: Tembo API - url: https://{deployment-origin}/api/public-api description: Self-hosted Tembo variables: deployment-origin: default: tembo.example.com description: Hostname of your self-hosted Tembo deployment security: [] paths: /v1/agents/{agentId}/triggers/{triggerId}: patch: tags: - Agents summary: Update an agent trigger description: Update an agent trigger configuration or enabled state. operationId: updateAgentTrigger parameters: - in: path name: agentId schema: type: string format: uuid required: true - in: path name: triggerId schema: type: string format: uuid required: true requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 200 integrationId: type: string format: uuid filters: $ref: '#/components/schemas/TriggerFilters' required: - name additionalProperties: false responses: '200': description: Update an agent trigger content: application/json: schema: type: object properties: id: type: string format: uuid triggerName: type: string enabledAt: type: - string - 'null' format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time agentId: type: string format: uuid triggerDisplayName: type: string minLength: 1 maxLength: 200 integrationId: type: - string - 'null' format: uuid integrationType: type: - string - 'null' filters: $ref: '#/components/schemas/TriggerFilters' required: - id - triggerName - enabledAt - createdAt - updatedAt - agentId - triggerDisplayName - integrationId - integrationType - filters additionalProperties: false '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false '404': description: Resource not found content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false '409': description: Resource conflict content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false '500': description: Agent operation failed content: application/json: schema: type: object properties: error: type: string required: - error additionalProperties: false security: - apiKey: [] components: schemas: TriggerFilters: anyOf: - allOf: - $ref: '#/components/schemas/AtlassianIssueAddedToBoardFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/AtlassianIssueAssignedToUserFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/AtlassianIssueCreatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/AtlassianIssueLabelAddedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/AtlassianIssueStatusChangedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/AtlassianIssueUpdatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/BitbucketPullRequestOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubCreateFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubIssueClosedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubIssueCommentCreatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubIssueOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubPullRequestClosedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubPullRequestMergedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubPullRequestOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubPullRequestReadyForReviewFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubReleasePublishedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubPullRequestSynchronizeFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubTemboPullRequestOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GithubWorkflowRunFailedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabBotMergeRequestCommentFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabIssueClosedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabIssueOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabMergeRequestClosedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabMergeRequestMergedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabMergeRequestOpenedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabMergeRequestUpdatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabPipelineFailedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/GitlabRefCreatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/LinearIssueCreateFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/LinearIssueLabelAddedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/LinearIssueStatusChangedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/LinearIssueUpdatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/SentryIssueCreatedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/SlackMessageReactionAddedFilters' additionalProperties: {} - allOf: - $ref: '#/components/schemas/SlackMessageSentInChannelFilters' additionalProperties: {} - type: object properties: spaces: type: array items: type: string description: >- Only trigger if the page is in a space with one of these names or IDs titleContains: type: array items: type: string description: Only trigger if the page title contains one of these substrings additionalProperties: {} - type: object properties: spaces: type: array items: type: string description: >- Only trigger if the page is in a space with one of these names or IDs titleContains: type: array items: type: string description: Only trigger if the page title contains one of these substrings previousSpaces: type: array items: type: string description: >- Only trigger if the page was moved from a space with one of these names or IDs additionalProperties: {} - type: object properties: spaces: type: array items: type: string description: >- Only trigger if the page is in a space with one of these names or IDs titleContains: type: array items: type: string description: Only trigger if the page title contains one of these substrings locations: type: array items: type: string enum: - footer - inline description: Only trigger for footer comments, inline comments, or both additionalProperties: {} - type: object properties: spaces: type: array items: type: string description: >- Only trigger if the page is in a space with one of these names or IDs titleContains: type: array items: type: string description: Only trigger if the page title contains one of these substrings labels: type: array items: type: string description: Only trigger if the added label has one of these values commentContains: type: array items: type: string description: Only trigger if the comment contains one of these substrings additionalProperties: {} - type: object properties: spaces: type: array items: type: string description: >- Only trigger if the page is in a space with one of these names or IDs titleContains: type: array items: type: string description: Only trigger if the page title contains one of these substrings labels: type: array items: type: string description: Only trigger if the removed label has one of these values commentContains: type: array items: type: string description: Only trigger if the comment contains one of these substrings additionalProperties: {} - allOf: - $ref: '#/components/schemas/EmptyTriggerFilters' additionalProperties: {} description: >- Conditions that determine whether the selected integration event starts the agent. Available fields depend on the integration and event type. AtlassianIssueAddedToBoardFilters: type: object properties: projects: type: array items: type: string description: Only trigger if the issue is in one of the specified projects boards: type: array items: type: string description: Only trigger if the issue is on one of the specified boards statuses: type: array items: type: string description: >- Only trigger if the issue was moved to one of the specified statuses (board columns) assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels includeNewIssues: type: boolean description: Also trigger for newly created issues (not just status changes) AtlassianIssueAssignedToUserFilters: type: object properties: projects: type: array items: type: string description: Only trigger if the issue is in one of the specified projects assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels includeNewIssues: type: boolean description: Also trigger for newly created issues that are already assigned AtlassianIssueCreatedFilters: type: object properties: projects: type: array items: type: string description: Only trigger if the issue is in one of the specified projects issueTypes: type: array items: type: string description: >- Only trigger for the specified issue types, such as Story, Bug, or Sub-task. assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels AtlassianIssueLabelAddedFilters: type: object properties: labels: type: array items: type: string description: Only trigger if one of the specified labels was added AtlassianIssueStatusChangedFilters: type: object properties: projects: type: array items: type: string description: Only trigger if the issue is in one of the specified projects statuses: type: array items: type: string description: Only trigger if the issue was moved to one of the specified statuses previousStatuses: type: array items: type: string description: >- Only trigger when the issue changes from one of the specified previous statuses. issueTypes: type: array items: type: string description: >- Only trigger for the specified issue types, such as Story, Bug, or Sub-task. assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels AtlassianIssueUpdatedFilters: type: object properties: projects: type: array items: type: string description: Only trigger if the issue is in one of the specified projects issueTypes: type: array items: type: string description: >- Only trigger for the specified issue types, such as Story, Bug, or Sub-task. assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels BitbucketPullRequestOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories openedBy: type: array items: type: string description: >- Only trigger if the pull request was opened by one of the specified users temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubCreateFilters: type: object properties: repositories: type: array items: type: string refType: type: array items: type: string enum: - branch - tag description: 'Only trigger for the specified Git reference type: branch or tag.' branchNames: type: array items: type: string tagNames: type: array items: type: string GithubIssueClosedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the issue is in one of the repositories openedBy: type: array items: type: string description: Only trigger if the issue was opened by one of the specified users temboIssues: type: boolean description: Enable agent for Tembo-created issues (disabled by default) GithubIssueCommentCreatedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the comment is in one of the repositories commentedBy: type: array items: type: string description: >- Only trigger if the comment was created by one of the specified users commentOn: type: array items: type: string enum: - issues - pull_requests description: Trigger on comments on issues, pull requests, or both messageContains: type: array items: type: string description: Only trigger if the comment contains one of these substrings GithubIssueOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the issue is in one of the repositories openedBy: type: array items: type: string description: Only trigger if the issue was opened by one of the specified users temboIssues: type: boolean description: Enable agent for Tembo-created issues (disabled by default) GithubPullRequestClosedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories openedBy: type: array items: type: string description: >- Only trigger if the pull request was opened by one of the specified users temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubPullRequestMergedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories mergedBy: type: array items: type: string description: >- Only trigger if the pull request was merged by one of the specified users temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubPullRequestOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories labels: type: array items: type: string description: >- Only trigger if the pull request has at least one of the specified labels openedBy: type: array items: type: string description: >- Only trigger if the pull request was opened by one of the specified users branches: type: array items: type: string description: Only trigger if the pull request targets one of these branches draftPrs: type: boolean description: Trigger also for draft pull requests (disabled by default) temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubPullRequestReadyForReviewFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories openedBy: type: array items: type: string description: >- Only trigger if the pull request was opened by one of the specified users temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubReleasePublishedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the release is in one of the repositories GithubPullRequestSynchronizeFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories pushedBy: type: array items: type: string description: >- Only trigger if the commits were pushed by one of the specified users draftPrs: type: boolean description: Trigger even if the pull request is a draft temboPrs: type: boolean description: Enable agent for Tembo-created pull requests (disabled by default) GithubTemboPullRequestOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pull request is in one of the repositories draftPrs: type: boolean description: Also trigger for draft pull requests GithubWorkflowRunFailedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the workflow run is in one of the repositories workflowNames: type: array items: type: string description: Only trigger for specific workflow names branches: type: array items: type: string description: Only trigger for specific branches GitlabBotMergeRequestCommentFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the comment is in one of the repositories botUsernames: type: array items: type: string description: Only trigger if the comment is from one of these bot usernames GitlabIssueClosedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the issue is in one of the repositories closedBy: type: array items: type: string description: Only trigger if the issue was closed by one of the specified users temboIssues: type: boolean description: Enable agent for Tembo-created issues (disabled by default) GitlabIssueOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the issue is in one of the repositories openedBy: type: array items: type: string description: Only trigger if the issue was opened by one of the specified users temboIssues: type: boolean description: Enable agent for Tembo-created issues (disabled by default) GitlabMergeRequestClosedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the merge request is in one of the repositories closedBy: type: array items: type: string description: >- Only trigger if the merge request was closed by one of the specified users temboMrs: type: boolean description: Enable agent for Tembo-created merge requests (disabled by default) GitlabMergeRequestMergedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the merge request is in one of the repositories mergedBy: type: array items: type: string description: >- Only trigger if the merge request was merged by one of the specified users temboMrs: type: boolean description: Enable agent for Tembo-created merge requests (disabled by default) GitlabMergeRequestOpenedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the merge request is in one of the repositories draftMrs: type: boolean description: >- Include draft merge requests. Drafts are excluded when omitted or false. temboMrs: type: boolean description: Enable agent for Tembo-created merge requests (disabled by default) GitlabMergeRequestUpdatedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the merge request is in one of the repositories pushedBy: type: array items: type: string description: >- Only trigger if the commits were pushed by one of the specified users draftMrs: type: boolean description: >- Include draft merge requests. Drafts are excluded when omitted or false. temboMrs: type: boolean description: Enable agent for Tembo-created merge requests (disabled by default) GitlabPipelineFailedFilters: type: object properties: repositories: type: array items: type: string description: Only trigger if the pipeline is in one of the repositories branches: type: array items: type: string description: Only trigger for specific branches GitlabRefCreatedFilters: type: object properties: repositories: type: array items: type: string refType: type: array items: type: string enum: - branch - tag description: 'Only trigger for the specified Git reference type: branch or tag.' branchNames: type: array items: type: string tagNames: type: array items: type: string LinearIssueCreateFilters: type: object properties: teams: type: array items: type: string description: Only trigger if the issue belongs to one of the specified teams states: type: array items: type: string description: >- Only trigger if the issue state type matches one of the specified types openedBy: type: array items: type: string description: Only trigger if the issue was opened by one of the specified users assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels temboIssues: type: boolean description: Enable agent for Tembo-created issues (disabled by default) LinearIssueLabelAddedFilters: type: object properties: teams: type: array items: type: string description: Only trigger if the issue belongs to one of the specified teams assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if one of the specified labels was added to the issue LinearIssueStatusChangedFilters: type: object properties: teams: type: array items: type: string description: Only trigger if the issue belongs to one of the specified teams statuses: type: array items: type: string description: Only trigger if the issue was moved to one of the specified statuses previousStatuses: type: array items: type: string description: >- Only trigger when the issue changes from one of the specified previous statuses. assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels LinearIssueUpdatedFilters: type: object properties: teams: type: array items: type: string description: Only trigger if the issue belongs to one of the specified teams states: type: array items: type: string description: >- Only trigger if the issue state type matches one of the specified types assignedTo: type: array items: type: string description: Only trigger if the issue is assigned to one of the specified users labels: type: array items: type: string description: Only trigger if the issue has at least one of the specified labels temboIssues: type: boolean description: Enable agent for Tembo-updated issues (disabled by default) SentryIssueCreatedFilters: type: object properties: priorities: type: array items: type: string enum: - high - medium - low description: Only trigger if the issue has one of the specified priorities projectSlugs: type: array items: type: string description: Only trigger if the issue is in one of the specified projects SlackMessageReactionAddedFilters: type: object properties: emojis: type: array items: type: string description: Only trigger if one of these emoji reactions is added channels: type: array items: type: string description: Only trigger if the reaction is added in one of these channels users: type: array items: type: string description: Only trigger if the reaction is added by one of these user names SlackMessageSentInChannelFilters: type: object properties: channels: type: array items: type: string description: Only trigger if the message is sent in one of the channels users: type: array items: type: string description: Only trigger if the message was sent by one of these user names messageContains: type: array items: type: string description: Only trigger if the message contains one of these substrings EmptyTriggerFilters: type: object securitySchemes: apiKey: type: http scheme: bearer ````