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

# Recover an eligible personal monitor run

> Requires explicit user intent. Continues recoverable waiting work, republishes failed handoffs or creates a linked retry of a failed execution. Keeps the original task and capabilities. Repeat the same requestId and expectedVersion after a transport or publication failure; this cannot start another generation. A stale version requires fresh inspection. Uncertain effects and waiting delegated-research replacement require support.




## OpenAPI

````yaml /openapi/tools-v1.yaml post /api/tools/v1/workflows/{workflowId}/runs/{id}/retry
openapi: 3.1.0
info:
  title: Govly Tools API
  version: 1.0.0-alpha
  description: >
    ALPHA / UNSTABLE: This API is still in active development. Endpoint
    behavior, request fields, response fields, error codes, and operation names
    may change before the Tools API is declared stable.

    REST-callable tool surface for agent and automation workflows. Agents are
    the primary consumer, but integrations can be built on this API. Responses
    are JSON for typed clients; MCP tools may render action results into
    text-oriented formats separately.

    Validating requests: validate against this schema in your client before
    sending. Govly ignores a request field it does not recognize rather than
    rejecting it, so a misspelled filter name is not applied — the response
    returns 200 with a broader result set than you intended, and nothing marks
    the difference. Where a request body declares `additionalProperties: false`,
    strict client-side validation is what catches that. Fields sent with the
    wrong type are rejected with 400 on most endpoints; validate types in your
    client too rather than relying on it.

    Rate limits: each resource (for example awards, opportunities, or
    workspaces) allows 70 requests per minute per user. Exceeding it returns 429
    with the standard error envelope, `code: rate_limited`, and a `Retry-After`
    header. Keys sent in the `X-API-KEY` header are also subject to the
    Enterprise API limit of 300 requests per minute per key; see the Rate Limits
    page.
servers:
  - url: https://app.govly.com
security:
  - bearerApiKey: []
  - headerApiKey: []
tags:
  - name: Workflows
    description: Workflow reference file management.
  - name: Opportunities
    description: Search, fetch, and inspect Govly opportunity records.
  - name: Awards
    description: Search and inspect awarded government contracts.
  - name: Contacts
    description: Search and inspect government points of contact.
  - name: Signals
    description: Search clustered procurement and market intelligence signals.
  - name: Places
    description: Resolve place names to canonical Govly Place ids.
  - name: Product Catalogs
    description: List government contract price lists and search their line items.
  - name: Workspaces
    description: Create, update, and inspect opportunity workspaces.
  - name: Organization Users
    description: Discover the members of your organization and their account status.
  - name: Workspace Members
    description: Add users and teams to workspaces.
  - name: File Attachments
    description: >-
      Attach new or existing files through a signed Govly transfer or an
      authorized reference.
  - name: Workspace Attachments
    description: List and upload workspace attachments.
  - name: Workspace Comments
    description: Post comments to workspaces.
  - name: Organization Labels
    description: List, create, rename, recolor, and delete the organization's labels.
  - name: Record Labels
    description: >-
      Apply and remove the organization's labels on opportunities, awards,
      contacts, and workspaces.
  - name: Follows
    description: Follow opportunities and related workspace activity.
  - name: Shares
    description: Share opportunities, awards, and contacts with colleagues by email.
  - name: Saved Searches
    description: List saved opportunity searches and cached matches.
  - name: Documents
    description: >-
      Read document representations and request temporary original-file
      downloads.
  - name: Libraries
    description: Discover accessible Libraries and create additional Libraries.
  - name: Library Documents
    description: List and manage documents in a selected Library.
  - name: Quote Submissions
    description: >-
      Inspect quote submission requirements, submit quotes, and poll submission
      status.
  - name: Inbox
    description: Read and triage the authenticated user's matched inbox items.
paths:
  /api/tools/v1/workflows/{workflowId}/runs/{id}/retry:
    parameters:
      - name: workflowId
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
    post:
      tags:
        - Workflows
      summary: Recover an eligible personal monitor run
      description: >
        Requires explicit user intent. Continues recoverable waiting work,
        republishes failed handoffs or creates a linked retry of a failed
        execution. Keeps the original task and capabilities. Repeat the same
        requestId and expectedVersion after a transport or publication failure;
        this cannot start another generation. A stale version requires fresh
        inspection. Uncertain effects and waiting delegated-research replacement
        require support.
      operationId: retry_monitor_run
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - requestId
                - expectedVersion
              properties:
                requestId:
                  type: string
                  minLength: 1
                  maxLength: 128
                expectedVersion:
                  type: string
                  pattern: ^[0-9a-f]{64}$
      responses:
        '200':
          description: >-
            Accepted recovery identity and observed state; queued does not mean
            completed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      run:
                        $ref: '#/components/schemas/MonitorRun'
                      operation:
                        type: string
                        enum:
                          - continue
                          - retry
                          - enqueue
                          - resume
                          - finalize_and_retry
                      continued:
                        type: boolean
                      publication:
                        type:
                          - string
                          - 'null'
                        enum:
                          - queued
                          - failed
                          - pending
                          - stopped
                          - unchanged
                          - null
        '404':
          $ref: '#/components/responses/Error'
        '409':
          $ref: '#/components/responses/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    MonitorRun:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
        runStatus:
          type: string
          enum:
            - queued
            - running
            - completed
            - needs_attention
            - failed
            - cancelled
        runStatusDetail:
          type:
            - string
            - 'null'
        createdAt:
          type: string
          format: date-time
        startedAt:
          type:
            - string
            - 'null'
          format: date-time
        completedAt:
          type:
            - string
            - 'null'
          format: date-time
        links:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
              url:
                type: string
        recovery:
          type: object
          properties:
            eligible:
              type: boolean
            operation:
              type:
                - string
                - 'null'
            reason:
              type:
                - string
                - 'null'
            detail:
              type:
                - string
                - 'null'
            version:
              type: string
        workflowId:
          type: string
        savedInstructions:
          type:
            - string
            - 'null'
        rootExecutionId:
          type: string
        retryOfExecutionId:
          type:
            - string
            - 'null'
        successorExecutionId:
          type:
            - string
            - 'null'
        modelResult:
          type:
            - object
            - 'null'
          properties:
            outcome:
              type: string
            findings:
              type: string
            requirements:
              type: array
              items:
                type: string
            sourceReferences:
              type: array
              items:
                type: string
            remainingWork:
              type: array
              items:
                type: string
        modelResultUnavailableReason:
          type:
            - string
            - 'null'
        actions:
          type: array
          description: Receipt-backed actions from this run and its delegated work.
          items:
            type: object
            properties:
              toolName:
                type: string
              status:
                type: string
              verifiedEffect:
                type: boolean
        actionCount:
          type: integer
        actionsTruncated:
          type: boolean
    ErrorEnvelope:
      type: object
      required:
        - errors
      properties:
        errors:
          type: array
          items:
            type: object
            required:
              - status
              - code
              - title
              - detail
            properties:
              status:
                type: string
              code:
                type: string
              title:
                type: string
              detail:
                type: string
              source:
                type: object
                properties:
                  pointer:
                    type: string
    RateLimitError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
  responses:
    Error:
      description: Error response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    RateLimited:
      description: >
        Too many requests. Two limiters can produce this status and they use
        different bodies. The per-user limit of 70 requests per minute for each
        resource returns the standard error envelope with `code: rate_limited`
        and a `Retry-After` header. Keys sent in the `X-API-KEY` header are also
        subject to the Enterprise API limit of 300 requests per minute per key,
        which returns the plain `error` form with `Retry-After` and the
        `X-RateLimit-*` headers. Clients should accept either body.
      headers:
        Retry-After:
          description: Seconds to wait before retrying.
          schema:
            type: string
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ErrorEnvelope'
              - $ref: '#/components/schemas/RateLimitError'
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      bearerFormat: API key
    headerApiKey:
      type: apiKey
      in: header
      name: X-API-KEY

````

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