> ## Documentation Index > Fetch the complete documentation index at: https://developers.datagrid.com/llms.txt > Use this file to discover all available pages before exploring further. # List event triggers > List the App Event automations (event triggers) configured for the specified agent. An event trigger fires the agent in response to an external provider event (e.g. a Procore webhook such as `Tasks:create`). An agent has at most one event trigger, so the returned list contains zero or one item and `has_more` is always `false`. ## OpenAPI ````yaml get /agents/{agent_id}/event-triggers openapi: 3.0.3 info: version: 0.1.1 title: Datagrid API description: Datagrid API servers: - url: https://api.datagrid.com/v1 security: - BearerAuth: [] paths: /agents/{agent_id}/event-triggers: get: tags: - Event Triggers summary: List event triggers description: >- List the App Event automations (event triggers) configured for the specified agent. An event trigger fires the agent in response to an external provider event (e.g. a Procore webhook such as `Tasks:create`). An agent has at most one event trigger, so the returned list contains zero or one item and `has_more` is always `false`. operationId: ListAgentEventTriggers parameters: - name: agent_id in: path required: true description: The ID of the agent whose event triggers to list. schema: type: string responses: '200': description: List of event triggers for the agent content: application/json: schema: $ref: '#/components/schemas/AgentEventTriggerListResponse' '404': description: >- Not found. The requested agent does not exist, or the authenticated API key does not have permission to access it. '429': description: >- Rate limit exceeded. The request has been throttled because the rate limit for this endpoint has been reached. Check the `Retry-After` response header and retry after the specified number of seconds. content: application/json: schema: $ref: '#/components/schemas/RateLimitError' components: schemas: AgentEventTriggerListResponse: type: object required: - object - data - has_more properties: object: type: string enum: - list description: The object type, always 'list'. data: type: array items: $ref: '#/components/schemas/AgentEventTrigger' description: Array of event trigger objects for the agent (zero or one). has_more: type: boolean description: >- Always `false` — an agent has at most one event trigger, so results are never paginated. RateLimitError: type: object description: >- Returned when the rate limit is exceeded. Rate limits are enforced per teamspace, endpoint path, and HTTP method over a 60-second sliding window. Each endpoint may have its own limit — check the X-RateLimit-Limit response header for the effective value. required: - error - message - retryable - status_code properties: status_code: type: integer description: The HTTP status code (429). statusCode: type: integer deprecated: true description: Deprecated. Use status_code instead. error: type: string enum: - rate_limit_exceeded description: The error code identifying this as a rate limit error. message: type: string description: A human-readable error message. mitigation: type: string description: Suggested action to resolve the error. retryable: type: boolean description: Whether the request can be retried after a delay. details: type: object properties: reason: type: string description: A detailed explanation of why the rate limit was exceeded. AgentEventTrigger: type: object required: - object - id - enabled - trigger_source - trigger_event - name - description - run_conditions - response_thread - created_at - updated_at properties: object: type: string enum: - event_trigger description: The object type, always 'event_trigger'. id: type: string description: Unique identifier for the event trigger. enabled: type: boolean description: >- Whether the trigger is active. When `false` the agent does not run in response to the event until it is re-enabled. trigger_source: $ref: '#/components/schemas/AgentEventTriggerSource' trigger_event: type: string description: >- The event that fires the agent, in `"ResourceName:eventType"` format (e.g. `"Tasks:create"`, `"Project Users:update"`). name: type: string description: User-provided name for the App Event automation. nullable: true description: type: string description: User-provided description of what the App Event automation does. nullable: true run_conditions: type: string description: >- Optional natural-language conditions that must hold for the agent to run when the event fires. When null, the agent runs on every matching event. nullable: true response_thread: $ref: '#/components/schemas/AgentEventTriggerResponseThread' nullable: true created_at: type: string format: date-time description: ISO 8601 timestamp of when the event trigger was created. updated_at: type: string format: date-time description: ISO 8601 timestamp of the last modification to the event trigger. AgentEventTriggerSource: type: string description: >- The external provider that emits the event. Currently only Procore is supported. enum: - procore AgentEventTriggerResponseThread: type: string description: >- Controls how the agent's response conversation is threaded when the trigger fires. `create_new_thread_each_time` starts a fresh thread for every event; when omitted, responses reuse a single thread. enum: - create_new_thread_each_time securitySchemes: BearerAuth: type: http scheme: bearer ````