Sustema

ENTITY developer reference

FeedbackResult

Candidate documentation for reading and synthetic examples. Account creation, live API access, SDKs, collections and MCP are not available here. A released service profile and matching integration instructions are required before use.

This is a documentation reading view of an unreleased candidate, not a downloadable replacement schema. Public wire names, types and constraints are retained except for the explicitly marked private-only subsets and route patterns. Private governance references are explained in public language. Use only a separately released, verified generation for clients. Read the explicit exclusions.

This is the public candidate schema reading view. Read it with the operation that uses it; a representable field does not establish enabled coverage or entitlement.

All customer-observable fields, headers, errors, retry/status paths, expiry, policy and notification decisions depend only on this caller's owned actions/admission and currently permitted public facts. Private scope cooldown, counts, group membership or shared job lifecycle cannot choose the public projection or continuation. Owned queued/running states describe admitted evaluation/reconciliation, never proof of a separate native job. Reuse may be disclosed only through lawful published evidence. Aggregate service overload is separately documented and cannot be a disguised subject-specific private counter.

Declared type: "object"

Declared fields

This list shows only properties declared directly in this schema. Required labels refer only to this schema’s own required array. Referenced, composed and conditional rules can add constraints; a field not listed as required here is not guaranteed to be optional.

feedback_id

Listed in this schema’s required array.

Declared type
"string"
Declared format
"uuid"
Reading definition for feedback_id
{
  "type": "string",
  "format": "uuid",
  "x-profile-maxLength": "string_characters_max"
}

revision

Listed in this schema’s required array.

Owned public projection revision; not the internal shared-job revision. Evidence If-Match uses this value.

Declared type
"integer"
Reading definition for revision
{
  "type": "integer",
  "minimum": 1,
  "description": "Owned public projection revision; not the internal shared-job revision. Evidence If-Match uses this value."
}

state

Listed in this schema’s required array.

Declared type
"string"
Reading definition for state
{
  "type": "string",
  "enum": [
    "received",
    "awaiting_evidence_or_signal",
    "recheck_queued",
    "rechecking",
    "updated",
    "unchanged",
    "needs_more_information",
    "unresolved",
    "awaiting_refresh_capacity",
    "duplicate_attached",
    "closed"
  ],
  "x-profile-maxLength": "string_characters_max"
}

projection

Listed in this schema’s required array.

Declared type
"string"
Reading definition for projection
{
  "type": "string",
  "enum": [
    "full_permitted",
    "redacted"
  ],
  "x-profile-maxLength": "string_characters_max"
}

target

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for target
{
  "anyOf": [
    {
      "$ref": "#/components/schemas/FeedbackTarget"
    },
    {
      "type": "null"
    }
  ]
}

reason_code

Listed in this schema’s required array.

Declared type
"string"
Reading definition for reason_code
{
  "type": "string",
  "enum": [
    "accepted",
    "insufficient_signal",
    "evidence_requested",
    "funding_or_capacity_wait",
    "recheck_started",
    "verified_update",
    "no_supported_change",
    "inconclusive",
    "lifecycle_restricted",
    "duplicate",
    "rights_restricted",
    "reference_expired",
    "closed"
  ],
  "x-profile-maxLength": "string_characters_max"
}

explanation

Listed in this schema’s required array.

Declared type
"string"
Reading definition for explanation
{
  "type": "string",
  "minLength": 1,
  "maxLength": 1200,
  "x-profile-maxLength": "string_characters_max"
}

next_action

Listed in this schema’s required array.

Declared type
"string"
Reading definition for next_action
{
  "type": "string",
  "enum": [
    "none",
    "poll_status",
    "provide_requested_evidence",
    "inspect_updated_result",
    "wait_for_refresh",
    "report_closed"
  ],
  "x-profile-maxLength": "string_characters_max"
}

created_at

Listed in this schema’s required array.

Declared type
"string"
Declared format
"date-time"
Reading definition for created_at
{
  "type": "string",
  "format": "date-time",
  "x-profile-maxLength": "string_characters_max"
}

updated_at

Listed in this schema’s required array.

Last change of this permitted owned projection, not a hidden internal job timestamp.

Declared type
"string"
Declared format
"date-time"
Reading definition for updated_at
{
  "type": "string",
  "format": "date-time",
  "description": "Last change of this permitted owned projection, not a hidden internal job timestamp.",
  "x-profile-maxLength": "string_characters_max"
}

expires_at

Listed in this schema’s required array.

Declared type
"string"
Declared format
"date-time"
Reading definition for expires_at
{
  "type": "string",
  "format": "date-time",
  "x-profile-maxLength": "string_characters_max"
}

recheck_reference

Listed in this schema’s required array.

Per-owned-report opaque alias only for independently disclosable progress; never a shared job identifier or authority.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for recheck_reference
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ],
  "description": "Per-owned-report opaque alias only for independently disclosable progress; never a shared job identifier or authority."
}

updated_subject

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for updated_subject
{
  "anyOf": [
    {
      "$ref": "#/components/schemas/SubjectRef"
    },
    {
      "type": "null"
    }
  ]
}

related_adjustment_request_id

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for related_adjustment_request_id
{
  "anyOf": [
    {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    {
      "type": "null"
    }
  ]
}

customer_debit_units

Listed in this schema’s required array.

Declared type
Not declared directly; consult the complete field definition.
Reading definition for customer_debit_units
{
  "const": "0"
}

policy_revision

Listed in this schema’s required array.

Declared type
"string"
Reading definition for policy_revision
{
  "type": "string",
  "minLength": 1,
  "maxLength": 200,
  "x-profile-maxLength": "string_characters_max"
}

Schema reading view

Read all retained constraints, including any allOf, oneOf, anyOf, conditional and additional-property constraints. The field list does not combine branches. Explicitly marked private-only omissions mean this view is not an executable substitute for the original schema or a released contract.

{
  "type": "object",
  "properties": {
    "feedback_id": {
      "type": "string",
      "format": "uuid",
      "x-profile-maxLength": "string_characters_max"
    },
    "revision": {
      "type": "integer",
      "minimum": 1,
      "description": "Owned public projection revision; not the internal shared-job revision. Evidence If-Match uses this value."
    },
    "state": {
      "type": "string",
      "enum": [
        "received",
        "awaiting_evidence_or_signal",
        "recheck_queued",
        "rechecking",
        "updated",
        "unchanged",
        "needs_more_information",
        "unresolved",
        "awaiting_refresh_capacity",
        "duplicate_attached",
        "closed"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "projection": {
      "type": "string",
      "enum": [
        "full_permitted",
        "redacted"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "target": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/FeedbackTarget"
        },
        {
          "type": "null"
        }
      ]
    },
    "reason_code": {
      "type": "string",
      "enum": [
        "accepted",
        "insufficient_signal",
        "evidence_requested",
        "funding_or_capacity_wait",
        "recheck_started",
        "verified_update",
        "no_supported_change",
        "inconclusive",
        "lifecycle_restricted",
        "duplicate",
        "rights_restricted",
        "reference_expired",
        "closed"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "explanation": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1200,
      "x-profile-maxLength": "string_characters_max"
    },
    "next_action": {
      "type": "string",
      "enum": [
        "none",
        "poll_status",
        "provide_requested_evidence",
        "inspect_updated_result",
        "wait_for_refresh",
        "report_closed"
      ],
      "x-profile-maxLength": "string_characters_max"
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "x-profile-maxLength": "string_characters_max"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Last change of this permitted owned projection, not a hidden internal job timestamp.",
      "x-profile-maxLength": "string_characters_max"
    },
    "expires_at": {
      "type": "string",
      "format": "date-time",
      "x-profile-maxLength": "string_characters_max"
    },
    "recheck_reference": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ],
      "description": "Per-owned-report opaque alias only for independently disclosable progress; never a shared job identifier or authority."
    },
    "updated_subject": {
      "anyOf": [
        {
          "$ref": "#/components/schemas/SubjectRef"
        },
        {
          "type": "null"
        }
      ]
    },
    "related_adjustment_request_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "x-profile-maxLength": "string_characters_max"
        },
        {
          "type": "null"
        }
      ]
    },
    "customer_debit_units": {
      "const": "0"
    },
    "policy_revision": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "x-profile-maxLength": "string_characters_max"
    }
  },
  "required": [
    "feedback_id",
    "revision",
    "state",
    "projection",
    "target",
    "reason_code",
    "explanation",
    "next_action",
    "created_at",
    "updated_at",
    "expires_at",
    "recheck_reference",
    "updated_subject",
    "related_adjustment_request_id",
    "customer_debit_units",
    "policy_revision"
  ],
  "additionalProperties": false,
  "description": "All customer-observable fields, headers, errors, retry/status paths, expiry, policy and notification decisions depend only on this caller's owned actions/admission and currently permitted public facts. Private scope cooldown, counts, group membership or shared job lifecycle cannot choose the public projection or continuation. Owned queued/running states describe admitted evaluation/reconciliation, never proof of a separate native job. Reuse may be disclosed only through lawful published evidence. Aggregate service overload is separately documented and cannot be a disguised subject-specific private counter.",
  "allOf": [
    {
      "if": {
        "properties": {
          "projection": {
            "const": "redacted"
          }
        },
        "required": [
          "projection"
        ]
      },
      "then": {
        "properties": {
          "target": {
            "type": "null"
          },
          "updated_subject": {
            "type": "null"
          },
          "recheck_reference": {
            "type": "null"
          },
          "related_adjustment_request_id": {
            "type": "null"
          }
        }
      }
    }
  ],
  "x-public-state-transitions": {
    "received": [
      "awaiting_evidence_or_signal",
      "needs_more_information",
      "recheck_queued",
      "awaiting_refresh_capacity",
      "duplicate_attached",
      "unresolved",
      "closed",
      "updated",
      "unchanged",
      "received"
    ],
    "awaiting_evidence_or_signal": [
      "needs_more_information",
      "recheck_queued",
      "awaiting_refresh_capacity",
      "duplicate_attached",
      "closed",
      "updated",
      "unchanged",
      "unresolved",
      "awaiting_evidence_or_signal"
    ],
    "recheck_queued": [
      "rechecking",
      "awaiting_refresh_capacity",
      "unresolved",
      "closed",
      "updated",
      "unchanged",
      "recheck_queued"
    ],
    "rechecking": [
      "updated",
      "unchanged",
      "unresolved",
      "needs_more_information",
      "awaiting_refresh_capacity",
      "closed",
      "rechecking"
    ],
    "updated": [
      "awaiting_evidence_or_signal",
      "closed",
      "updated"
    ],
    "unchanged": [
      "awaiting_evidence_or_signal",
      "closed",
      "unchanged"
    ],
    "needs_more_information": [
      "awaiting_evidence_or_signal",
      "recheck_queued",
      "awaiting_refresh_capacity",
      "duplicate_attached",
      "unresolved",
      "closed",
      "updated",
      "unchanged",
      "needs_more_information"
    ],
    "unresolved": [
      "awaiting_evidence_or_signal",
      "closed",
      "unresolved"
    ],
    "awaiting_refresh_capacity": [
      "recheck_queued",
      "unresolved",
      "closed",
      "updated",
      "unchanged",
      "awaiting_refresh_capacity"
    ],
    "duplicate_attached": [
      "updated",
      "unchanged",
      "unresolved",
      "needs_more_information",
      "awaiting_refresh_capacity",
      "closed",
      "duplicate_attached"
    ],
    "closed": []
  },
  "x-public-state-guards": {
    "default": "Only owned admitted actions or permitted public facts can advance the public state/revision/time. A supported outcome may be projected directly from waiting; internal stages need not be disclosed.",
    "terminal": "A result requires supported evidence available under this report's current rights and original scope. Bounded reconsideration needs either newly submitted eligible owned evidence or a materially relevant lawful publication under the existing policy; private thresholds/completions alone never reopen it. Expired/closed reports do not reopen.",
    "duplicate_attached": "Only an independently disclosable duplicate of this caller's own report; never disclose a private cross-tenant dedup group.",
    "closed": "Only own explicit closure, admitted expiry/rights rule or complete owned workflow closure; an internal job closing is insufficient. Closed is final. Internal report closure is atomic with this public closure; shared job termination is separate.",
    "notifications": "Only a changed public projection binding may create a customer intent.",
    "evidence": "Errors, accept/reject, retry_action and status_path use the public lifecycle, never hidden internal state.",
    "same_state": "The table allows non-closed same-state transitions only for an accepted owned evidence/action or a changed permitted public-content digest. Advance public revision/timestamp once for that event. A read, identical idempotent replay, private transition or unchanged digest alone is not a revision bump; closed has no mutation transition."
  }
}

Related schemas

All API operations