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

# Update an action rule

> Full-replace update of a rule. Requires an org owner or admin token.



## OpenAPI

````yaml api-reference/openapi.yml PUT /{projectId}/action-rules/{ruleId}
openapi: 3.0.3
info:
  title: TestDino Public API
  version: 1.0.0
  description: >
    Public API for TestDino: read access to test analytics, manual tests, and
    project data, plus

    manual-testing write endpoints.


    **Read (GET) endpoints** cover analytics, runs, cases, and project data.
    **Write endpoints

    (POST/PATCH)** create and update manual-testing entities: suites, cases,
    releases, sessions, and

    manual runs (including per-case verdicts). Query parameters are
    **endpoint-specific**; see each

    operation for supported filters, enums, and defaults.


    Writes require a PAT whose owner holds a writer role (owner/admin/member) on
    the project's

    organization; a viewer-role token gets `403`.


    ## Authentication


    All endpoints require a Bearer token in the `Authorization` header:

    ```

    Authorization: Bearer td_pat_<token>

    ```


    Use a user PAT (`td_pat_` prefix) scoped to the organization/project.


    ## Rate Limiting


    - **Reads (per-token):** 100 requests/minute

    - **Writes (per-token):** 60 requests/minute

    - **Manual run creation (per-token):** 10 requests/minute

    - **Per-IP (pre-auth):** 200 requests/minute

    - **PDF generation:** 1 request/minute per token


    Standard headers: `RateLimit-Limit`, `RateLimit-Remaining`,
    `RateLimit-Reset`


    ## Response Format


    **Success:**

    ```json

    { "success": true, "data": { ... }, "pagination": { ... } }

    ```


    **Error:**

    ```json

    { "success": false, "error": { "code": "ERROR_CODE", "message":
    "Human-readable message" } }

    ```


    ## Time windows and date filters


    There is **no global date-filter convention**. Each endpoint documents its
    own parameters:


    | Endpoint family | Parameter | Allowed values |

    |-----------------|-----------|------------------|

    | Test runs list | `start_date`, `end_date` | RFC3339 timestamps (both
    required together) |

    | Explorer, specs, analytics | `days` | Integer snapped to **7, 30, or 90**
    (see each endpoint) |

    | Test runs list | — | No preset `period` / `dateRange` params |

    | Dashboard, filters | — | **No query params** (fixed snapshot) |


    ## Served by
  contact:
    name: TestDino Support
    url: https://docs.testdino.com
servers:
  - url: https://api.testdino.com/api/v1/public
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Token Info
    description: Token introspection and project metadata
  - name: Test Runs
    description: List, inspect, and drill into test runs
  - name: Test Cases
    description: Automated test case details and history
  - name: Specs
    description: Project-level spec file health
  - name: Manual Tests
    description: Manual test suites and cases (read-only)
  - name: Test Case Explorer
    description: Aggregated test case metrics explorer
  - name: Context
    description: >-
      Debugging payload at three levels (run / suite / test) — error, steps,
      failure window, attempts, attachments, trace, deep links, and a copy-paste
      retry command. Designed for AI agents and CI scripts.
  - name: Dashboard
    description: Project health overview
  - name: Filters
    description: Available filter values (environments, branches, developers, tags)
  - name: Reports
    description: PDF report generation and download
  - name: Analytics
    description: Consolidated analytics summary and test case execution performance
  - name: Webhooks
    description: Outbound webhook subscriptions and delivery history
  - name: Usage
    description: Subscription usage and limits
  - name: Actions
    description: Rules that skip, quarantine, or tag tests on the next test run
paths:
  /{projectId}/action-rules/{ruleId}:
    put:
      tags:
        - Actions
      summary: Full-replace update (org owner/admin only)
      description: >-
        Same body as create; a PAST `expiresAt` is accepted (the rule reads as
        expired).
      parameters:
        - $ref: '#/components/parameters/projectId'
        - name: ruleId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The updated ActionRule
        '400':
          description: Validation failure
        '403':
          description: PAT owner is not an org owner/admin
        '404':
          description: '`RULE_NOT_FOUND`'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  parameters:
    projectId:
      name: projectId
      in: path
      required: true
      schema:
        type: string
      description: >-
        The project identifier (e.g. `project_abc123`). Must match the project
        associated with your PAT.
  responses:
    RateLimited:
      description: Rate limit exceeded
      headers:
        RateLimit-Limit:
          description: Max requests allowed in the current window
          schema:
            type: integer
            example: 100
        RateLimit-Remaining:
          description: Requests remaining in the current window
          schema:
            type: integer
            example: 0
        RateLimit-Reset:
          description: Seconds until the current window resets
          schema:
            type: integer
            example: 42
        Retry-After:
          description: Seconds to wait before retrying
          schema:
            type: integer
            example: 60
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
          example:
            success: false
            error:
              code: RATE_LIMIT_EXCEEDED
              message: Too many requests
  schemas:
    ErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: User PAT (td_pat_) scoped to the target project

````