list_issue_spaces

Generated automatically from the published contract sources.

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.

A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/actions/list_issue_spaces, with a bearer credential and the action's payload as the JSON body. It also accepts GET.

Contract description

List the issue spaces your account holds, your own and each application's own, with each one's identifier, kind, and creation instant, and for an application's space its application.

Access and action metadata

{
  "name": "list_issue_spaces",
  "resource": "account",
  "tier": "observe",
  "summary": "List the issue spaces the account holds, oldest first: each space's identifier, its kind, and the instant it was created. The kind is `account` for a space the account created, or `application` for an application's own space, whose entry names `application`. A space an application holds for one environment is not listed, since no `issues` token reaches it. To the account the platform names as its own space's owner, that space comes last, kind `platform`. A token minted with the `issues` grant names one of these. Registered while the issue service's origin is configured.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

MCP catalog entry

{
  "name": "list_issue_spaces",
  "tier": "observe",
  "scenario": "API-L0-20",
  "summary": "List the issue spaces your account holds, your own and each application's own, with each one's identifier, kind, and creation instant, and for an application's space its application.",
  "owners": [
    "MAPI-14"
  ]
}

request

JSON pointer Description and constraints
"" (root) Type: object

response

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["contract_version","spaces"]
/properties/contract_version Required value: 1
/properties/reference The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call's record row carries; quote it when reporting the call.

Type: string
Pattern: ^[0-9a-f]{10}$
/properties/spaces The spaces the account holds, oldest first, the platform's own space last where it is listed. A space an application holds for one environment is not listed, since no `issues` token reaches it.

Type: array
/properties/spaces/items Type: object
Required fields: ["id","kind","created_at"]
/properties/spaces/items/properties/id Type: string
/properties/spaces/items/properties/kind `account` for a space the account created, `application` for an application's own space, and `platform` for the platform's own space.

Type: string
Allowed values: ["account","application","platform"]
/properties/spaces/items/properties/application With the kind `application`: the application whose own space this is.

Type: string
/properties/spaces/items/properties/created_at Type: ["string","null"]

Complete payload contract

{
  "request": {
    "type": "object",
    "properties": {}
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "spaces"
    ],
    "properties": {
      "contract_version": {
        "const": 1
      },
      "reference": {
        "type": "string",
        "pattern": "^[0-9a-f]{10}$",
        "description": "The short reference the platform recorded this call under, ten lowercase hexadecimal characters, the value the call's record row carries; quote it when reporting the call."
      },
      "spaces": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "kind",
            "created_at"
          ],
          "properties": {
            "id": {
              "type": "string"
            },
            "kind": {
              "type": "string",
              "enum": [
                "account",
                "application",
                "platform"
              ],
              "description": "`account` for a space the account created, `application` for an application's own space, and `platform` for the platform's own space."
            },
            "application": {
              "type": "string",
              "description": "With the kind `application`: the application whose own space this is."
            },
            "created_at": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        },
        "description": "The spaces the account holds, oldest first, the platform's own space last where it is listed. A space an application holds for one environment is not listed, since no `issues` token reaches it."
      }
    }
  }
}

Shared contracts