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

# Get a settled Browser observation

> Returns one already-settled, bounded, sanitized Browser observation under its exact Computer and Screen. Raw provider coordinates, screenshot bytes, form values, hidden sensitive fields, browser chrome, and unrelated targets cannot fit the response. A mismatched resource path is not addressable, and an admission that has not settled remains absent.

Checkfu support posture: alpha; hosted. No release evidence journey applies to this operation.



## OpenAPI

````yaml /openapi.json get /v1/computers/{id}/screens/{screen_id}/observations/{observation_id}
openapi: 3.1.0
info:
  title: Checkfu API
  version: '2026-08-29'
  description: >-
    Authentication is declared per operation: API-key, runtime, or connector
    bearer; Automation signature; or credential-free pairing redemption. Every
    general Checkfu REST request requires the dated `Checkfu-Version` header
    (one of: 2026-08-29); the three MCP JSON-RPC transports use
    `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth
    callback carries neither Checkfu header. API keys resolve one Workspace
    without a request selector; authenticated responses identify it with
    `Checkfu-Workspace-Id`.
servers:
  - url: https://api.checkfu.com
security:
  - bearerAuth: []
tags:
  - name: organizations
  - name: sourceRepositories
  - name: tenants
  - name: workspaces
  - name: principals
  - name: principalGroups
  - name: principalAccessCredentials
  - name: apiKeys
  - name: agents
  - name: harnesses
  - name: harnessRuntime
  - name: computerProfiles
  - name: permissionAssignments
  - name: actionPolicies
  - name: files
  - name: memoryStores
  - name: dreams
  - name: modelCredentials
  - name: modelRoutingProfiles
  - name: blueprintInstallations
  - name: toolSources
  - name: skills
  - name: skillSources
  - name: agentSources
  - name: skillProposals
  - name: instructionProposals
  - name: catalog
  - name: concepts
  - name: support
  - name: connections
  - name: connectionVaults
  - name: connectionAssignments
  - name: connectedRuntimes
  - name: projects
  - name: collaboration
  - name: automationGraphs
  - name: automations
  - name: actionApprovals
  - name: standingApprovals
  - name: usage
  - name: models
  - name: outcomes
  - name: budgets
  - name: billing
  - name: sessions
  - name: audit
  - name: sessionExports
  - name: runs
  - name: runnerPools
  - name: transcripts
  - name: sessionWatches
  - name: sessionHandoffs
  - name: sessionCapsules
  - name: sessionTrajectories
  - name: webhookEndpoints
  - name: integrationGateway
  - name: agentDeployments
  - name: workEnvironments
  - name: computers
  - name: computerScreens
  - name: computerBrowserObservations
  - name: computerBrowserActions
  - name: environments
  - name: vaults
  - name: apiMcp
  - name: a2a
paths:
  /v1/computers/{id}/screens/{screen_id}/observations/{observation_id}:
    get:
      tags:
        - computerBrowserObservations
      summary: Get a settled Browser observation
      description: >-
        Returns one already-settled, bounded, sanitized Browser observation
        under its exact Computer and Screen. Raw provider coordinates,
        screenshot bytes, form values, hidden sensitive fields, browser chrome,
        and unrelated targets cannot fit the response. A mismatched resource
        path is not addressable, and an admission that has not settled remains
        absent.


        Checkfu support posture: alpha; hosted. No release evidence journey
        applies to this operation.
      operationId: computerBrowserObservations.getComputerBrowserObservation
      parameters:
        - name: id
          in: path
          schema:
            $ref: '#/components/schemas/ComputerId'
          required: true
        - name: screen_id
          in: path
          schema:
            $ref: '#/components/schemas/ScreenId'
          required: true
        - name: observation_id
          in: path
          schema:
            $ref: '#/components/schemas/BrowserObservationId'
          required: true
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-29'
          required: true
      responses:
        '200':
          description: >-
            A bounded sanitized Browser observation bound to its exact authority
            and content digest.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrowserObservation'
          headers:
            checkfu-workspace-id:
              description: The Workspace resolved from the authenticated bearer credential.
              required: true
              schema:
                $ref: '#/components/schemas/WorkspaceId'
        '400':
          description: Typed Checkfu wire error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - validation.malformed
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#validation-malformed
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    required:
                      - type
                      - message
                      - more
                    additionalProperties: false
                additionalProperties: false
        '401':
          description: Typed Checkfu wire error
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - auth.invalid_key
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#auth-invalid-key
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '403':
          description: >-
            The organization, tenant, or workspace backing this key is
            administratively disabled. | Deployment governance or retention
            policy denied the request.
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    required:
                      - error
                    properties:
                      error:
                        type: object
                        properties:
                          type:
                            type: string
                            enum:
                              - auth.disabled_tenancy
                          message:
                            type: string
                          more:
                            type: string
                            enum:
                              - >-
                                https://docs.checkfu.com/reference/errors#auth-disabled-tenancy
                            description: >-
                              Stable public documentation and remedy for this
                              error type.
                        required:
                          - type
                          - message
                          - more
                        additionalProperties: false
                    additionalProperties: false
                  - $ref: '#/components/schemas/PolicyDeniedError'
        '404':
          description: >-
            The requested resource does not exist in the resolved deployment
            boundary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationNotFoundError'
        '429':
          description: Typed Checkfu wire error
          headers:
            retry-after:
              description: >-
                Delay in seconds for rate limits or deployment quotas with a
                known release or UTC reset boundary
              required: false
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: object
                    required:
                      - type
                      - message
                      - more
                    properties:
                      type:
                        type: string
                        enum:
                          - budget.exceeded
                      message:
                        type: string
                      more:
                        type: string
                        enum:
                          - >-
                            https://docs.checkfu.com/reference/errors#budget-exceeded
                        description: >-
                          Stable public documentation and remedy for this error
                          type.
                    additionalProperties: false
                additionalProperties: false
        '500':
          description: >-
            An unexpected internal failure occurred; the message contains an
            opaque incident reference.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeInternalError'
      security:
        - bearerAuth: []
components:
  schemas:
    ComputerId:
      type: string
      allOf:
        - pattern: ^comp_[0-9a-f]{32}$
    ScreenId:
      type: string
      allOf:
        - pattern: ^scrn_[0-9a-f]{32}$
    BrowserObservationId:
      type: string
      allOf:
        - pattern: ^bobs_[0-9a-f]{32}$
    BrowserObservation:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/BrowserObservationId'
        request_fingerprint:
          type: string
          allOf:
            - pattern: ^sha256:[0-9a-f]{64}$
        workspace_id:
          $ref: '#/components/schemas/WorkspaceId'
        computer_id:
          $ref: '#/components/schemas/ComputerId'
        computer_generation:
          type: integer
          allOf:
            - exclusiveMinimum: 0
        screen_id:
          $ref: '#/components/schemas/ScreenId'
        attachment_id:
          $ref: '#/components/schemas/ComputerAttachmentId'
        session_id:
          $ref: '#/components/schemas/SessionId'
        run_id:
          $ref: '#/components/schemas/RunId'
        run_attempt_id:
          $ref: '#/components/schemas/RunAttemptId'
        acting_principal_id:
          $ref: '#/components/schemas/PrincipalId'
        control_epoch:
          type: integer
          allOf:
            - minimum: 0
        observation_generation:
          type: integer
          allOf:
            - minimum: 0
        payload:
          type: object
          properties:
            active_target:
              anyOf:
                - type: object
                  properties:
                    label:
                      type: string
                      allOf:
                        - minLength: 1
                        - maxLength: 128
                        - pattern: ^[a-z0-9][a-z0-9._-]*$
                    origin:
                      type: string
                      allOf:
                        - maxLength: 2048
                    title:
                      anyOf:
                        - type: string
                          allOf:
                            - minLength: 1
                            - maxLength: 512
                        - type: 'null'
                    viewport:
                      type: object
                      properties:
                        width:
                          type: integer
                          allOf:
                            - exclusiveMinimum: 0
                            - maximum: 16384
                        height:
                          type: integer
                          allOf:
                            - exclusiveMinimum: 0
                            - maximum: 16384
                      required:
                        - width
                        - height
                      additionalProperties: false
                  required:
                    - label
                    - origin
                    - title
                    - viewport
                  additionalProperties: false
                - type: 'null'
            accessibility_tree:
              type: array
              items:
                type: object
                properties:
                  key:
                    type: string
                    allOf:
                      - minLength: 1
                      - maxLength: 64
                      - pattern: ^[a-zA-Z0-9._-]+$
                  parent_key:
                    anyOf:
                      - type: string
                        allOf:
                          - minLength: 1
                          - maxLength: 64
                          - pattern: ^[a-zA-Z0-9._-]+$
                      - type: 'null'
                  role:
                    type: string
                    allOf:
                      - minLength: 1
                      - maxLength: 512
                  accessible_name:
                    anyOf:
                      - type: string
                        allOf:
                          - minLength: 1
                          - maxLength: 512
                      - type: 'null'
                  description:
                    anyOf:
                      - type: string
                        allOf:
                          - minLength: 1
                          - maxLength: 512
                      - type: 'null'
                  interactive:
                    type: boolean
                  disabled:
                    type: boolean
                  focused:
                    type: boolean
                  masked:
                    type: boolean
                required:
                  - key
                  - parent_key
                  - role
                  - accessible_name
                  - description
                  - interactive
                  - disabled
                  - focused
                  - masked
                additionalProperties: false
              allOf:
                - maxItems: 2048
            target_summaries:
              type: array
              items:
                type: object
                properties:
                  label:
                    type: string
                    allOf:
                      - minLength: 1
                      - maxLength: 128
                      - pattern: ^[a-z0-9][a-z0-9._-]*$
                  origin:
                    type: string
                    allOf:
                      - maxLength: 2048
                  title:
                    anyOf:
                      - type: string
                        allOf:
                          - minLength: 1
                          - maxLength: 512
                      - type: 'null'
                  active:
                    type: boolean
                required:
                  - label
                  - origin
                  - title
                  - active
                additionalProperties: false
              allOf:
                - maxItems: 64
            screenshot:
              anyOf:
                - type: object
                  properties:
                    file_id:
                      $ref: '#/components/schemas/FileId'
                    custody:
                      type: string
                      enum:
                        - ephemeral
                        - retained_by_policy
                    media_type:
                      type: string
                      enum:
                        - image/png
                        - image/jpeg
                        - image/webp
                    sha256:
                      type: string
                      allOf:
                        - pattern: ^sha256:[0-9a-f]{64}$
                    bytes:
                      type: integer
                      allOf:
                        - exclusiveMinimum: 0
                        - maximum: 8388608
                    expires_at:
                      $ref: '#/components/schemas/CurrentTimestamp'
                  required:
                    - file_id
                    - custody
                    - media_type
                    - sha256
                    - bytes
                    - expires_at
                  additionalProperties: false
                - type: 'null'
            sanitization:
              type: object
              properties:
                policy_digest:
                  type: string
                  allOf:
                    - pattern: ^sha256:[0-9a-f]{64}$
                sensitive_fields_excluded:
                  type: integer
                  allOf:
                    - minimum: 0
                hidden_nodes_excluded:
                  type: integer
                  allOf:
                    - minimum: 0
                secret_regions_masked:
                  type: integer
                  allOf:
                    - minimum: 0
                browser_chrome_excluded:
                  type: boolean
                unrelated_targets_excluded:
                  type: boolean
              required:
                - policy_digest
                - sensitive_fields_excluded
                - hidden_nodes_excluded
                - secret_regions_masked
                - browser_chrome_excluded
                - unrelated_targets_excluded
              additionalProperties: false
            truncated:
              type: boolean
          required:
            - active_target
            - accessibility_tree
            - target_summaries
            - screenshot
            - sanitization
            - truncated
          additionalProperties: false
        payload_digest:
          type: string
          allOf:
            - pattern: ^sha256:[0-9a-f]{64}$
        captured_at:
          $ref: '#/components/schemas/CurrentTimestamp'
      required:
        - id
        - request_fingerprint
        - workspace_id
        - computer_id
        - computer_generation
        - screen_id
        - attachment_id
        - session_id
        - run_id
        - run_attempt_id
        - acting_principal_id
        - control_epoch
        - observation_generation
        - payload
        - payload_digest
        - captured_at
      additionalProperties: false
    WorkspaceId:
      type: string
      allOf:
        - pattern: ^wrkspc_[0-9a-f]{32}$
    PolicyDeniedError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - policy.denied
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#policy-denied
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: Deployment governance or retention policy denied the request.
    ValidationNotFoundError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - validation.not_found
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#validation-not-found
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        The requested resource does not exist in the resolved deployment
        boundary.
    RuntimeInternalError:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - runtime.internal
            message:
              type: string
            more:
              type: string
              enum:
                - https://docs.checkfu.com/reference/errors#runtime-internal
              description: Stable public documentation and remedy for this error type.
          required:
            - type
            - message
            - more
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: >-
        An unexpected internal failure occurred; the message contains an opaque
        incident reference.
    ComputerAttachmentId:
      type: string
      allOf:
        - pattern: ^catt_[0-9a-f]{32}$
    SessionId:
      type: string
      allOf:
        - pattern: ^sess_[0-9a-f]{32}$
    RunId:
      type: string
      allOf:
        - pattern: ^run_[0-9a-f]{32}$
    RunAttemptId:
      type: string
      allOf:
        - pattern: ^ratt_[0-9a-f]{32}$
    PrincipalId:
      type: string
      allOf:
        - pattern: ^prin_[0-9a-f]{32}$
    FileId:
      type: string
      allOf:
        - pattern: ^file_[0-9a-f]{32}$
    CurrentTimestamp:
      type: string
      allOf:
        - maxLength: 24
        - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$
          description: A canonical UTC ISO-8601 timestamp with millisecond precision.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````