Get one WatchFox finding event with captured input and output

GET

/v1/runtimes/{runtime_id}/watchfox/findings/{finding_id}

curl --request GET \
  --url http://127.0.0.1:8080/v1/runtimes/example/watchfox/findings/example \
  --header 'Authorization: Bearer <token>'

• Local development server
• Hosted REST API

Authorizations

• BearerAuth

Parameters

Path Parameters

runtime_id

required

string

finding_id

required

string

Responses

200

WatchFox finding detail response.

Media typeapplication/json

object

data

required

object

id

required

string

event_id

required

string

runtime_id

required

string

runtime_name

required

string

provider

string

nullable

tool_name

string

nullable

tool_call_id

string

nullable

observed_at

required

string format: date-time

observed_unix_ms

required

integer format: int64

input_chars

required

integer format: int64

output_chars

required

integer format: int64

total_chars

required

integer format: int64

estimated_input_tokens

required

integer format: int64

estimated_output_tokens

required

integer format: int64

estimated_total_tokens

required

integer format: int64

estimated_savings_tokens

required

integer format: int64

truncated

required

boolean

parse_error

string

nullable

analysis_issues

required

Array<object>

object

kind

required

string

Allowed values: truncated_capture parse_error

severity

required

string

Allowed values: info warning danger

confidence

required

string

Allowed values: low medium high

title

required

string

detail

required

string

findings

required

Array<object>

object

kind

required

string

Allowed values: large_output repeated_lines repeated_keys repeated_paths repeated_call

severity

required

string

Allowed values: info warning danger

confidence

required

string

Allowed values: low medium high

title

required

string

detail

required

string

estimated_savings_tokens

required

integer format: int64

input_preview

required

string

output_preview

required

string

input_text

required

string

output_text

required

string

Example

{
  "data": {
    "analysis_issues": [
      {
        "kind": "truncated_capture",
        "severity": "info",
        "confidence": "low"
      }
    ],
    "findings": [
      {
        "kind": "large_output",
        "severity": "info",
        "confidence": "low"
      }
    ]
  }
}

401

Missing, malformed, or rejected bearer token

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

403

The bearer token is not allowed to perform this action

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

404

The requested resource was not found

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

409

The request conflicts with current resource state

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

422

Validation or application error

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

429

Rate limit exceeded

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

503

Upstream service is unavailable

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

504

Upstream request timed out

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}

default

Error response

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: already_exists command_failed deadline_exceeded failed_precondition internal invalid_argument not_found permission_denied rate_limited unauthenticated unavailable unimplemented

message

required

string

Example

{
  "error": {
    "code": "already_exists"
  }
}