submitFeedback

POST

/v1/feedback

• Production
• Local

Uses the authenticated support boundary. Lists default to own/shared reports across authorized projects. IDs suffice for reads and replies. Creation requires an explicit, linked-feedback, or unambiguous project; ambiguity returns authorized choices. No project administration permission is required. Raw writes require client_id and exact request replay; resolve/reopen also require expected_version. Inaccessible records return indistinguishable 404s.

Authorizations

• AgentKey

Parameters

Query Parameters

project_id

string

Optional concrete authorized project. Omit to use authenticated support context.

Request Body ^required

object

client_id

required

string format: uuid

submission_mode

required

string

Allowed values: explicit automatic

category

required

string

Allowed values: unexpected_error incorrect_result missing_capability confusing_behavior other

user_intent

required

string

>= 1 characters <= 500 characters

expected_behavior

string

<= 1000 characters

observed_behavior

required

string

>= 1 characters <= 2000 characters

outcome

required

string

Allowed values: blocked completed_with_workaround observation

attempts

Array<object>

<= 20 items

object

operation

required

string

>= 1 characters <= 80 characters

http_status

integer

>= 100 <= 599

error_code

string

<= 80 characters

summary

string

<= 300 characters

resource_refs

Array<object>

<= 20 items

object

type

required

string

Allowed values: inbox review submission thread domain

id

required

string

>= 1 characters <= 200 characters

client_versions

object

mcp

string

<= 100 characters

sdk

string

<= 100 characters

host

string

<= 100 characters

skill

string

<= 100 characters

runtime

string

<= 100 characters

os

string

<= 100 characters

Responses

201

Committed result

object

id

required

string

project_id

required

string

evidence

required

object

client_id

required

string format: uuid

submission_mode

required

string

Allowed values: explicit automatic

category

required

string

Allowed values: unexpected_error incorrect_result missing_capability confusing_behavior other

user_intent

required

string

>= 1 characters <= 500 characters

expected_behavior

string

<= 1000 characters

observed_behavior

required

string

>= 1 characters <= 2000 characters

outcome

required

string

Allowed values: blocked completed_with_workaround observation

attempts

Array<object>

<= 20 items

object

operation

required

string

>= 1 characters <= 80 characters

http_status

integer

>= 100 <= 599

error_code

string

<= 80 characters

summary

string

<= 300 characters

resource_refs

Array<object>

<= 20 items

object

type

required

string

Allowed values: inbox review submission thread domain

id

required

string

>= 1 characters <= 200 characters

client_versions

object

mcp

string

<= 100 characters

sdk

string

<= 100 characters

host

string

<= 100 characters

skill

string

<= 100 characters

runtime

string

<= 100 characters

os

string

<= 100 characters

repeat_count

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

api_build

required

string

redacted_fields

required

Array<string>

diagnostics

Array<object>

object

type

string

id

string

state

string

observed_ms

integer format: int64

org_id

string

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

linked_cases

Array<object>

object

id

required

string

project_id

required

string

status

required

string

version

required

integer format: int64

linked_cases_truncated

boolean

400

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

401

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

403

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

404

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

409

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

410

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

429

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string

503

Request failed; inspect the stable problem code.

RFC-9457 problem+json error body. code is a closed machine enum clients switch on; type is a dereferenceable URI under https://extrovert.dev/problems/. Served as application/problem+json.

object

reason

Structured support failure reason without changing the existing code.

string

next_action

Suggested recovery action within existing access.

string

projects

object

object

required

string

Allowed values: list

data

required

Array<object>

object

id

required

string

org_id

required

string

name

required

string

has_more

required

boolean

next_cursor

required

string

current_state

object

id

required

string

number

required

string

project_id

required

string

title

required

string

status

required

string

Allowed values: received working waiting_on_customer resolved

impact

required

string

Allowed values: blocked workaround_available recovered unknown

version

required

integer format: int64

created_ms

required

integer format: int64

updated_ms

required

integer format: int64

resolved_ms

integer format: int64

customer_confirmed_ms

integer format: int64

resolution_kind

string

resolution_summary

string

feedback_id

required

string

org_id

string

console_url

string

latest_update

object

id

required

string

sequence

required

integer format: int64

kind

required

string

actor_kind

required

string

Allowed values: customer staff

body

required

string

created_ms

required

integer format: int64

observed_runtime

object

source

string

package_version

string

profile

string

profile_version

string

build

string

transport

string

catalog_digest

string

instance_id

string

request_id

string

observed_ms

integer format: int64

truncated

required

boolean

unsent_text

Retained text after a concurrent case change.

string

type

required

string format: uri

title

required

string

status

required

integer

detail

string

code

required

The CLOSED machine code. The Review Loop members split what used to be a single opaque conflict, because an agent must take a DIFFERENT action on each: stale (the revision/version you named is no longer current; nothing was mutated; re-read, re-apply, resubmit; retryable, bounded) and born_stale (built against an older rule high-water; re-read the rules or restamp_review; at most one retry per high-water) are the ONLY retryable 409s. wrong_state means this VERB is illegal from the current state while the draft is still live; never retry the same verb, read the state and the repeated allowed_action hints in errors[] and pick a legal one. terminal means the review is already sent/auto_sent/cancelled and nothing will EVER succeed; stop, and drain your review events for the outcome. send_needs_reconciliation means a prior send is unconfirmed and parked. Do not resend. Poll instead. unavailable (503) is the retryable fail-closed answer when a dependency could not be read; it carries Retry-After and is distinct from not_configured, which is permanent for this deployment.

string

Allowed values: bad_request unauthorized forbidden_scope not_found conflict support_record_deleted idempotency_conflict breadth_required quota_exceeded rate_limited domain_not_allowed recipient_blocked recipient_suppressed not_configured domain_unavailable internal reply_context_required reply_context_changed reply_workflow_required reply_already_pending intent_required wrong_state terminal stale born_stale send_needs_reconciliation graduation_locked maturity_gate_unmet scope_taken unavailable

request_id

string

errors

Array<object>

object

field

string

code

string

detail

string