Skip to content
Extrovert Extrovert Docs

createSupportCase

POST
/v1/admin/orgs/{org_id}/projects/{project_id}/support-cases

Human console membership and participation required. Delegated callers require explicit support scopes. All writes use a UUID client_id, atomically commit with their receipt, and require a concrete project. Cross-scope records return 404. Never retry a send because support was submitted.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
org_id
required
string
project_id
required
string

Request Body required

Section titled “Request Body required ”

Provide exactly one of description, feedback_id, or feedback. Raw HTTP requires client_id; MCP, CLI and TypeScript SDK generate retry IDs. Omitted impact is unknown.

object
client_id
required
string format: uuid
title
required
string
>= 1 characters <= 200 characters
impact
string
default: unknown
Allowed values: blocked workaround_available recovered unknown
feedback_id
string
<= 200 characters
feedback
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
description
string
>= 1 characters <= 2000 characters

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Committed result

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
console_url
required
string
notification_queued
required
boolean
next_action
required
string
Allowed values: check_case_for_updates

400

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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

Section titled “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