Report

PUT

/connector/v1/preflights/{request_id}/report

Authorizations

• connector_bearer

Parameters

Path Parameters

request_id

required

string format: uuid

Request Body^required

Media typeapplication/json

object

report

required

object

checks

required

Array<object>

object

check

required

string

code

required

string

correction

required

string

outcome

required

string

Allowed values: passed failed unknown not_applicable

required

required

boolean

responsible_role

required

string

Allowed values: connector_owner host_administrator site_operator

connector_id

required

string

context_id

required

string

definition_hash

required

string

execution_mode

required

string

execution_uid

string | null

limitations

required

Array<string>

manifest_version

required

integer format: int32

observed_at

required

string

probe_id

string | null format: uuid

request_id

required

string format: uuid

source

required

string

Allowed values: local connector

session_id

required

string format: uuid

Responses

200

Media typeapplication/json

object

Headers

Cache-Control

string

No-store

x-request-id

string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

413

413: the request body exceeds the configured size limit.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object

code

required

Stable machine-readable error code.

string

details

One of:

null

null

object

Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.

object

truncated

required

More violations exist than fit in this response.

boolean

violations

required

At most eight violations, in validator traversal order.

Array<object>

<= 8 items

A schema failure without submitted values or arbitrary property names.

object

correction

required

Fixed guidance; actual bounds and allowed values remain in the publication schema.

string

<= 160 characters

position

required

JSON Pointer relative to inputs; the empty string denotes its root. Only ordinary, explicitly declared property names and array indices appear.

string

<= 128 characters

Example

/value

position_redacted

required

The position stops at a safe ancestor instead of naming the exact field.

boolean

rule

required

Stable categories independent of the validator’s free-form diagnostics.

string

Allowed values: type required additionalProperties propertyNames unevaluatedProperties minimum maximum exclusiveMinimum exclusiveMaximum multipleOf minLength maxLength pattern format enum const minItems maxItems uniqueItems additionalItems unevaluatedItems contains minProperties maxProperties anyOf oneOf not contentEncoding contentMediaType schema

message

required

Safe explanation without internal errors or submitted input values.

string

request_id

required

Matches the response’s x-request-id header.

string

Headers

Cache-Control

string

No-store

x-request-id

string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

default

An HTTP request failed; inspect the stable error code and request ID.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object

code

required

Stable machine-readable error code.

string

details

One of:

null

null

object

Bounded corrections for authorized scientific-schema failures only. Absent on other failures. The complete validation error body is <=4608 bytes.

object

truncated

required

More violations exist than fit in this response.

boolean

violations

required

At most eight violations, in validator traversal order.

Array<object>

<= 8 items

A schema failure without submitted values or arbitrary property names.

object

correction

required

Fixed guidance; actual bounds and allowed values remain in the publication schema.

string

<= 160 characters

position

required

JSON Pointer relative to inputs; the empty string denotes its root. Only ordinary, explicitly declared property names and array indices appear.

string

<= 128 characters

Example

/value

position_redacted

required

The position stops at a safe ancestor instead of naming the exact field.

boolean

rule

required

Stable categories independent of the validator’s free-form diagnostics.

string

Allowed values: type required additionalProperties propertyNames unevaluatedProperties minimum maximum exclusiveMinimum exclusiveMaximum multipleOf minLength maxLength pattern format enum const minItems maxItems uniqueItems additionalItems unevaluatedItems contains minProperties maxProperties anyOf oneOf not contentEncoding contentMediaType schema

message

required

Safe explanation without internal errors or submitted input values.

string

request_id

required

Matches the response’s x-request-id header.

string

Headers

Cache-Control

string

No-store

x-request-id

string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.