set_ai_passes #
On this page
Generated automatically from the published contract sources.
A script calls this action over HTTPS at POST https://tztrack.turnzero.ai/v1/set_ai_passes, with a bearer credential and the action's payload as the JSON body. An MCP connection lists this action as the tool tztrack_set_ai_passes.
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 #
Turn your issue space's AI passes option on or off. A session changes this option when the account owner requests that change. Otherwise, it leaves the option unchanged. If their choice is missing and nobody can answer, leave it unchanged and report. Turning on charges for the days left in the calendar month. A repeat charges nothing. Turning off gives nothing back. Passes require ai_reviews_enabled and either this option on an unpaused account or an unbilled owner. The answer's on is the stored option. The issue service takes it on its next account read.
More about this action #
A tzTrack token reaches this act where your tool's sign-in issued it. A token mint_token minted is refused tztrack_bounded.
Name a space your account owns, or a space bound to an application it owns, from list_issue_spaces. Each space has its own option. The act does not change ai_reviews_enabled; that setting alone runs no passes under usage pricing. Turning on sets the option only after the month's charge is posted or already covered. An unbilled account bypasses the balance check and incurs no real charge.
Every call before pricing reads usage refuses invalid_request, including turning off. The same refusal covers a missing or malformed space id or a missing or non-boolean on. space_not_owned means neither your account nor its application owns the space; use list_issue_spaces. A turn-on refuses balance_short where balance left is not more than the month's charge for the days left. rates_unread covers unread rate rows or switch instant. option_not_set means the option was not turned on, and any posted charge remains. Retry: in the same UTC calendar month, no further charge is posted while the month's charged count covers your AI passes options, including this one.
The returned on and moved show what is stored; no further read is needed to confirm the record. Pass eligibility changes when the issue service next reads the account, with no fixed delay promised.
Access and action metadata #
{
"name": "set_ai_passes",
"resource": "account",
"tier": "reversible",
"surface": "tztrack",
"addresses": [
"tztools"
],
"admits": [
"tztrack",
"device_sign_in"
],
"summary": "Turn your issue space's AI passes option on or off. A session changes this option when the account owner requests that change. Otherwise, it leaves the option unchanged. If their choice is missing and nobody can answer, leave it unchanged and report. Turning on charges for the days left in the calendar month. A repeat charges nothing. Turning off gives nothing back. Passes require `ai_reviews_enabled` and either this option on an unpaused account or an unbilled owner. The answer's `on` is the stored option. The issue service takes it on its next account read.\n\nA tzTrack token reaches this act where your tool's sign-in issued it. A token `mint_token` minted is refused `tztrack_bounded`.\n\nName a space your account owns, or a space bound to an application it owns, from `list_issue_spaces`. Each space has its own option. The act does not change `ai_reviews_enabled`; that setting alone runs no passes under usage pricing. Turning on sets the option only after the month's charge is posted or already covered. An unbilled account bypasses the balance check and incurs no real charge.\n\nEvery call before pricing reads usage refuses `invalid_request`, including turning off. The same refusal covers a missing or malformed space id or a missing or non-boolean `on`. `space_not_owned` means neither your account nor its application owns the space; use `list_issue_spaces`. A turn-on refuses `balance_short` where balance left is not more than the month's charge for the days left. `rates_unread` covers unread rate rows or switch instant. `option_not_set` means the option was not turned on, and any posted charge remains. Retry: in the same UTC calendar month, no further charge is posted while the month's charged count covers your AI passes options, including this one.\n\nThe returned `on` and `moved` show what is stored; no further read is needed to confirm the record. Pass eligibility changes when the issue service next reads the account, with no fixed delay promised.",
"annotations": {
"readOnlyHint": false,
"destructiveHint": true,
"openWorldHint": false,
"idempotentHint": true
}
}
MCP catalog entry #
{
"name": "set_ai_passes",
"title": "Set AI passes option",
"tier": "reversible",
"scenario": "API-L0-20",
"summary": "Turn your issue space's AI passes option on or off. A session changes this option when the account owner requests that change. Otherwise, it leaves the option unchanged. If their choice is missing and nobody can answer, leave it unchanged and report. Turning on charges for the days left in the calendar month. A repeat charges nothing. Turning off gives nothing back. Passes require `ai_reviews_enabled` and either this option on an unpaused account or an unbilled owner. The answer's `on` is the stored option. The issue service takes it on its next account read.",
"owners": [
"API-L0-30",
"ACB-L0-26",
"ACB-L0-90",
"ACB-L0-92",
"ITS-L0-04",
"PRC-L0-19"
]
}
request #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object Required fields: ["space","on"] |
| / |
The id of a space your account owns, or one bound to its application, as list_issue_spaces returns it. Type: string Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
| / |
True turns this space's AI passes option on; false turns it off. It does not change ai_reviews_enabled. Type: boolean |
response #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object Required fields: ["contract_version","space","on","moved"] |
| / |
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}$ |
| / |
The issue space id. Type: string |
| / |
The stored AI passes option; the issue service reads it on its next account refresh. Type: boolean |
| / |
True when the stored option changed; false when it already matched. Type: boolean |
Complete payload contract #
{
"request": {
"type": "object",
"required": [
"space",
"on"
],
"properties": {
"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": "The id of a space your account owns, or one bound to its application, as list_issue_spaces returns it."
},
"on": {
"type": "boolean",
"description": "True turns this space's AI passes option on; false turns it off. It does not change ai_reviews_enabled."
}
}
},
"response": {
"type": "object",
"required": [
"contract_version",
"space",
"on",
"moved"
],
"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."
},
"space": {
"type": "string",
"description": "The issue space id."
},
"on": {
"type": "boolean",
"description": "The stored AI passes option; the issue service reads it on its next account refresh."
},
"moved": {
"type": "boolean",
"description": "True when the stored option changed; false when it already matched."
}
}
}
}
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