> ## 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 automations > List all `runAgent` automations that belong to the specified agent. Returns automations in reverse-chronological order (newest first). Use the cursor pagination parameters (`limit`, `after`, `before`) to page through large result sets. ## OpenAPI ````yaml get /agents/{agent_id}/automations 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}/automations: get: tags: - Automations summary: List automations description: >- List all `runAgent` automations that belong to the specified agent. Returns automations in reverse-chronological order (newest first). Use the cursor pagination parameters (`limit`, `after`, `before`) to page through large result sets. operationId: ListAutomations parameters: - name: agent_id in: path required: true description: The ID of the agent whose automations to list. schema: type: string - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/after' - $ref: '#/components/parameters/before' responses: '200': description: List of automations for the agent content: application/json: schema: $ref: '#/components/schemas/AutomationListResponse' '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: parameters: limit: name: limit in: query schema: type: integer default: 50 minimum: 1 maximum: 100 required: false description: The limit on the number of objects to return, ranging between 1 and 100. after: name: after in: query schema: type: string required: false description: >- A cursor to use in pagination. `after` is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `after=obj_foo` to fetch the next page of the list. before: name: before in: query schema: type: string required: false description: >- A cursor to use in pagination. `before` is an object ID that defines your place in the list. For example, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `before=obj_bar` to fetch the previous page of the list. schemas: AutomationListResponse: 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/Automation' description: Array of automation objects for the current page. has_more: type: boolean description: >- Whether additional pages are available. When `true`, pass the ID of the last item in `data` as the `after` cursor to fetch the next page. 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. Automation: type: object required: - object - id - name - description - enabled - created_at - cron - timezone - prompt - thread_mode properties: object: type: string enum: - automation description: The object type, always 'automation'. id: type: string description: Unique identifier for the automation. name: type: string description: Human-readable name of the automation. description: type: string description: Optional free-text description of what this automation does. nullable: true enabled: type: boolean description: >- Whether the automation is active. When `false` the cron trigger is paused and no runs are scheduled until it is re-enabled. created_at: type: string format: date-time description: ISO 8601 timestamp of when the automation was created. updated_at: type: string format: date-time description: ISO 8601 timestamp of the last modification. nullable: true cron: type: string description: >- Five-field cron expression controlling when the automation fires (e.g. `"0 9 * * 1"` = every Monday at 09:00). Seconds are not supported. Must have a minimum inter-fire interval of 15 minutes. example: 0 9 * * 1 nullable: true timezone: type: string description: >- IANA timezone identifier in which `cron` is interpreted (e.g. `"America/New_York"`, `"UTC"`). Defaults to `"UTC"` when not provided on create. example: America/New_York nullable: true prompt: type: string description: >- The instruction text sent to the agent each time the automation fires. Supports Markdown. nullable: true thread_mode: $ref: '#/components/schemas/AutomationThreadMode' nullable: true destination_type: $ref: '#/components/schemas/AutomationDestinationType' nullable: true destination_id: type: string description: >- The channel ID or user ID that identifies the destination. Required when `destination_type` is `channel` or `user_dm`; omit for `agent_dm`. nullable: true output_channel_id: type: string description: >- ID of an additional delivery channel (Slack channel, Teams channel, email address, etc.) where automation results are also posted. nullable: true output_channel_type: type: string description: >- The transport type of the output channel. One of `"email"`, `"slack"`, `"teams"`, `"sms"`. nullable: true notification_preference: $ref: '#/components/schemas/AutomationNotificationPreference' nullable: true prompt_file_ids: type: array description: >- IDs of files attached to the automation prompt. These files are provided as context to the agent on every run. nullable: true items: type: string AutomationThreadMode: type: string enum: - new_thread - same_conversation description: >- Controls whether each scheduled run creates a fresh conversation thread or continues in the same persistent conversation. - `new_thread` — (default) Each run starts a new conversation. Results are isolated; the agent has no memory of prior runs unless it uses agent memory tools. - `same_conversation` — Every run appends to the same conversation thread. The agent sees the full history of prior runs, which is useful for incremental summaries or stateful workflows. AutomationDestinationType: type: string enum: - agent_dm - channel - user_dm description: |- Where the automation's conversation runs and results are delivered. - `agent_dm` — (default) Results are posted in the agent's own DM space. No `destination_id` is required. - `channel` — Results are posted in a specific Datagrid channel. Provide the channel ID in `destination_id`. - `user_dm` — Results are sent as a direct message to a specific user. Provide the user ID in `destination_id`. AutomationNotificationPreference: type: string enum: - always - on_failure - never description: >- Controls when users are notified about automation run outcomes. - `always` — Notify after every run regardless of success or failure. - `on_failure` — (default) Notify only when a run fails or produces an error. - `never` — Do not send notifications for this automation. securitySchemes: BearerAuth: type: http scheme: bearer ````