> ## 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.

# Inspect an exact personal monitor run

> Returns the original saved task and lineage, model-reported findings separately from receipt-backed action summaries, and current recovery readiness. Findings are withheld unless current runtime permissions and evidence can be verified, including monitor activity. Action summaries contain no raw arguments or results and are capped at 100, with a total and truncation indicator. A verified effect does not establish email delivery or task completion.




## OpenAPI

````yaml /openapi/tools-v1.yaml get /api/tools/v1/workflows/{workflowId}/runs/{id}
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}:
    parameters:
      - name: workflowId
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - Workflows
      summary: Inspect an exact personal monitor run
      description: >
        Returns the original saved task and lineage, model-reported findings
        separately from receipt-backed action summaries, and current recovery
        readiness. Findings are withheld unless current runtime permissions and
        evidence can be verified, including monitor activity. Action summaries
        contain no raw arguments or results and are capped at 100, with a total
        and truncation indicator. A verified effect does not establish email
        delivery or task completion.
      operationId: show_monitor_run
      responses:
        '200':
          description: Owner-authorized run detail.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/MonitorRun'
        '404':
          $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.