settle_feedback #
On this page
Generated automatically from the published contract sources.
A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/settle_feedback, with a bearer credential and the action's payload as the JSON body. An MCP connection lists this action as the tool settle_feedback.
OAuth access tokens and minted tokens, including the turnzero command's computer token, are bearer credentials. The action determines which kinds, scopes and grants it accepts (Sign-in, sessions, and tokens).
Build metadata: Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.
Contract description #
Settle an issue, or change its standing. Pass issue and act. The settle act takes an outcome and a resolution giving the proof or the ruling, and merge merges the issue into target. A merge of a praise issue with an issue of another kind is refused. On the platform's own space, only the platform operator or a token with the feedback_queue grant may call it. With space, the identifier of an issue space your account has, the call acts on an issue of that space, as its owner. Nothing is deleted. Every act is added to the issue's history.
More about this action #
The fixed_in argument is optional, and accepted only with a settle to done. It gives the build that serves the fix as release_line, version, and environment, where release_line is a declared release line or landing. Pass null where no build serves the fix yet. The platform passes it to the issue service as given.
The space argument is the identifier of an issue space your acting account has, a lowercase UUID. It is the account's own space, an application's own space as submit_manifest's receipt gives it, or one space of an application's per-environment pair. The act settles an issue of that space under the space's own token, as its owner's act, and no grant is checked. A request that passes application or environment is refused invalid_request, and the refusal gives space.
You can also wait an issue with a resolution saying what would reopen it, reopen it, or unmerge a duplicate. The triage act sets its kind or component and opens a new issue, so it can then be settled done.
Access and action metadata #
{
"name": "settle_feedback",
"resource": "account",
"tier": "reversible",
"surface": "account",
"addresses": [
"tztools",
"tzop"
],
"admits": [
"feedback_queue"
],
"summary": "Settle an issue: `act` is `settle` with an `outcome`, one of the record's eight, and a `resolution` giving the proof or the ruling, required for every outcome but `noted` and `duplicate`. Or `merge` the issue into `target`, its master; `wait` with a `resolution` saying what would reopen it; `reopen` a fixed, closed, or waiting issue; `unmerge` a duplicate; or `triage` it with its `kind` or `component`, which opens a `new` issue. The 0.2.0 `disposition` is read as its outcome. No act approves or declines a duplicate: the issue service's passes merge where they agree on stamped or confirmed evidence. A merge of a praise issue with an issue of another kind is refused `invalid_request` with `relation_refused`. An optional `key` is the act's idempotency key. An act the issue's state excludes is refused `invalid_request` with the service's refusal; nothing is deleted. A `new` issue closes by hand only `noted`, `duplicate`, `declined`, or `as_designed`, so `triage` it before settling it `done`. The answer carries the issue as it now is. On the platform's own space the act is admitted to `feedback_queue` or `super_admin`; every other credential is refused `grant_required`, which gives `feedback_queue`. The row's `admits` mark lists that grant. With `space`, the identifier of an issue space your account holds, the act settles an issue of that space under its own token, its owner's act, no grant read. A token bounded to an application is refused `token_scope_refused`. Registered while the issue service's origin is configured.",
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false
}
}
MCP catalog entry #
{
"name": "settle_feedback",
"title": "Settle feedback",
"tier": "reversible",
"scenario": "CHI-L0-14",
"summary": "Settle an issue, or change its standing. Pass `issue` and `act`. The `settle` act takes an `outcome` and a `resolution` giving the proof or the ruling, and `merge` merges the issue into `target`. A merge of a praise issue with an issue of another kind is refused. On the platform's own space, only the platform operator or a token with the `feedback_queue` grant may call it. With `space`, the identifier of an issue space your account has, the call acts on an issue of that space, as its owner. Nothing is deleted. Every act is added to the issue's history.",
"owners": [
"API-L0-20"
]
}
request #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object Required fields: ["issue","act"] Replaced members: application and environment were replaced by space |
| / |
The issue you settle, by its short identifier. Type: string Pattern: ^#[1-9][0-9]*$ |
| / |
The settling act, or triage, which sets the issue's kind or component and opens a new issue.Type: string Allowed values: ["settle","merge","reopen","wait","unmerge","triage"] |
| / |
The outcome a settle sets. Type: string Allowed values: ["verified","done","as_designed","declined","duplicate","superseded","noted","unexplained"] |
| / |
The 0.2.0 word read as an outcome; never beside outcome.Type: string Allowed values: ["fixed","not_an_issue","cannot_reproduce","declined"] |
| / |
The master of a merge, or of a settle with the outcome duplicate.Type: string Pattern: ^#[1-9][0-9]*$ |
| / |
What fixed it, the ruling, or why nothing changes, 1 to 4,000 characters; required for a settle but noted and duplicate, and for a wait, saying what would reopen it.Type: string Maximum length: 4000 |
| / |
With a settle to done alone, the build that serves the fix, release_line a declared line or landing, or null where none does. The service refuses invalid_request without it on a bug or a friction holding a report of a returning origin where no landing exists.Type: ["object","null"] Required fields: ["release_line","version","environment"] Additional properties: false |
| / |
Type: string Minimum length: 1 Maximum length: 200 |
| / |
Type: string Minimum length: 1 Maximum length: 200 |
| / |
Type: string Minimum length: 1 Maximum length: 200 |
| / |
With triage: the issue's kind, one of the record's eight.Type: string Allowed values: ["bug","gap","docs","friction","question","task","praise","idea"] |
| / |
With triage: a component the space admits, by its name or an alias. Any other name is refused invalid_request.Type: string Minimum length: 1 Maximum length: 64 |
| / |
The act's idempotency key. Type: string Maximum length: 200 |
| / |
Optional. An issue space your account holds: its own, or an application's own or per-environment one. Without it, the call addresses the platform's own space. A request that passes application or environment is refused invalid_request, and the refusal gives space.Type: string Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
response #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object Required fields: ["contract_version","issue"] |
| / |
Required value: 1 |
| / |
The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call's record row. Quote it when you report the call. Type: string Pattern: ^[0-9a-f]{10}$ |
| / |
An issue of the Issue Tracking record, whole as the queue's reader and a space's owner read it: its short identifier, kind, title, summary, workaround, component, requirements, labels, priority, effective_priority, impact_assessment, plan, state and outcome, the counts the service keeps, and its instants. It carries what it waits for and who claims it, the two members in the place of the holder. Through the projection, a reporter reads its own issues in the projected shape instead. Type: object |
| / |
Type: string Pattern: ^#[1-9][0-9]*$ |
| / |
Type: string Allowed values: ["bug","gap","docs","friction","question","task","praise","idea"] |
| / |
Type: string |
| / |
Type: string Allowed values: ["new","open","waiting","fixed","closed"] |
| / |
Type: ["string","null"] |
Complete payload contract #
{
"request": {
"type": "object",
"required": [
"issue",
"act"
],
"properties": {
"issue": {
"type": "string",
"pattern": "^#[1-9][0-9]*$",
"description": "The issue you settle, by its short identifier."
},
"act": {
"type": "string",
"enum": [
"settle",
"merge",
"reopen",
"wait",
"unmerge",
"triage"
],
"description": "The settling act, or `triage`, which sets the issue's kind or component and opens a `new` issue."
},
"outcome": {
"type": "string",
"enum": [
"verified",
"done",
"as_designed",
"declined",
"duplicate",
"superseded",
"noted",
"unexplained"
],
"description": "The outcome a settle sets."
},
"disposition": {
"type": "string",
"enum": [
"fixed",
"not_an_issue",
"cannot_reproduce",
"declined"
],
"description": "The 0.2.0 word read as an outcome; never beside `outcome`."
},
"target": {
"type": "string",
"pattern": "^#[1-9][0-9]*$",
"description": "The master of a merge, or of a settle with the outcome `duplicate`."
},
"resolution": {
"type": "string",
"maxLength": 4000,
"description": "What fixed it, the ruling, or why nothing changes, 1 to 4,000 characters; required for a settle but `noted` and `duplicate`, and for a wait, saying what would reopen it."
},
"fixed_in": {
"type": [
"object",
"null"
],
"required": [
"release_line",
"version",
"environment"
],
"properties": {
"release_line": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"version": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"environment": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"additionalProperties": false,
"description": "With a settle to `done` alone, the build that serves the fix, `release_line` a declared line or `landing`, or null where none does. The service refuses `invalid_request` without it on a `bug` or a `friction` holding a report of a returning origin where no landing exists."
},
"kind": {
"type": "string",
"enum": [
"bug",
"gap",
"docs",
"friction",
"question",
"task",
"praise",
"idea"
],
"description": "With `triage`: the issue's kind, one of the record's eight."
},
"component": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "With `triage`: a component the space admits, by its name or an alias. Any other name is refused `invalid_request`."
},
"key": {
"type": "string",
"maxLength": 200,
"description": "The act's idempotency key."
},
"space": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Optional. An issue space your account holds: its own, or an application's own or per-environment one. Without it, the call addresses the platform's own space. A request that passes `application` or `environment` is refused `invalid_request`, and the refusal gives `space`."
}
},
"x-renamed": {
"application": "space",
"environment": "space"
}
},
"response": {
"type": "object",
"required": [
"contract_version",
"issue"
],
"properties": {
"contract_version": {
"const": 1
},
"reference": {
"type": "string",
"pattern": "^[0-9a-f]{10}$",
"description": "The short reference the platform recorded your call under: ten lowercase hexadecimal characters, the value in the call's record row. Quote it when you report the call."
},
"issue": {
"type": "object",
"description": "An issue of the Issue Tracking record, whole as the queue's reader and a space's owner read it: its short identifier, kind, title, summary, workaround, component, requirements, labels, priority, effective_priority, impact_assessment, plan, state and outcome, the counts the service keeps, and its instants. It carries what it waits for and who claims it, the two members in the place of the holder. Through the projection, a reporter reads its own issues in the projected shape instead.",
"properties": {
"id": {
"type": "string",
"pattern": "^#[1-9][0-9]*$"
},
"kind": {
"type": "string",
"enum": [
"bug",
"gap",
"docs",
"friction",
"question",
"task",
"praise",
"idea"
]
},
"title": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"new",
"open",
"waiting",
"fixed",
"closed"
]
},
"outcome": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
Shared contracts #
- Refusals: every refusal, by surface, with its cause and its remedy
- schemas/wire_error.schema.json
- schemas/wire_errors.json
- schemas/action_payloads.json (includes shared shapes)
- management_api_contract.md