list_space_members #

View this page as Markdown

Generated automatically from the published contract sources.

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

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 #

List the members of an issue space you own; pass space. The answer's users counts the members plus you, and it gives your account's tzTrack tier. To add or remove a member, use share_space. Your account needs tzTrack, which every account has.

Access and action metadata #

{
  "name": "list_space_members",
  "resource": "account",
  "surface": "tztrack",
  "tier": "observe",
  "product": "tztrack",
  "admits": [
    "tztrack",
    "device_sign_in"
  ],
  "summary": "List the members of an issue space you own, with `users`, the members plus you, and your account's tzTrack tier. Pass `space`.",
  "annotations": {
    "readOnlyHint": true,
    "destructiveHint": false,
    "openWorldHint": false,
    "idempotentHint": true
  }
}

MCP catalog entry #

{
  "name": "list_space_members",
  "title": "List space members",
  "tier": "observe",
  "scenario": "API-L0-20",
  "summary": "List the members of an issue space you own; pass `space`. The answer's `users` counts the members plus you, and it gives your account's tzTrack tier. To add or remove a member, use `share_space`. Your account needs tzTrack, which every account has.",
  "owners": [
    "ITS-L0-07",
    "ACB-L0-92"
  ]
}

request #

JSON pointer Description and constraints
"" (root) Type: object
Required fields: ["space"]
/properties/space The space to read, a lower-case UUID of a space your account owns.

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","space","members","users","tztrack_tier","tztrack_grace_end"]
/properties/contract_version Required value: 1
/properties/reference 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}$
/properties/space The space shared.

Type: string
/properties/members The members of the space after the call, oldest first; you, the owner, are not among them.

Type: array
/properties/members/items Type: object
Required fields: ["account","address","level","added_at"]
/properties/members/items/properties/account The member's account identifier, the one its claims and its person:<account> carry.

Type: string
/properties/members/items/properties/address The sign-in email address the member was added by.

Type: string
/properties/members/items/properties/level Type: string
Allowed values: ["report","contribute","owner"]
/properties/members/items/properties/added_at The instant the member was added, or its level last moved.

Type: string
/properties/users The members plus you, the count a per-user price reads.

Type: integer
Minimum: 1
/properties/tztrack_tier Your account's tzTrack tier as the space's owner, after the call. It is derived at the read, so an add that starts a payment grace says so. It is introductory while tzTrack's introductory period runs; after it, paid, grace for an account that must pay inside its payment grace, stopped once that grace has ended, or free.

Type: string
Allowed values: ["introductory","paid","grace","stopped","free"]
/properties/tztrack_grace_end The end of your account's, the owner's, tzTrack payment grace, ISO 8601, where one was written, and null otherwise. Past it, an account that must pay and reads no paid tier reads stopped.

Type: ["string","null"]

Complete payload contract #

{
  "request": {
    "type": "object",
    "required": [
      "space"
    ],
    "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 space to read, a lower-case UUID of a space your account owns."
      }
    }
  },
  "response": {
    "type": "object",
    "required": [
      "contract_version",
      "space",
      "members",
      "users",
      "tztrack_tier",
      "tztrack_grace_end"
    ],
    "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 space shared."
      },
      "members": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "account",
            "address",
            "level",
            "added_at"
          ],
          "properties": {
            "account": {
              "type": "string",
              "description": "The member's account identifier, the one its claims and its `person:<account>` carry."
            },
            "address": {
              "type": "string",
              "description": "The sign-in email address the member was added by."
            },
            "level": {
              "type": "string",
              "enum": [
                "report",
                "contribute",
                "owner"
              ]
            },
            "added_at": {
              "type": "string",
              "description": "The instant the member was added, or its level last moved."
            }
          }
        },
        "description": "The members of the space after the call, oldest first; you, the owner, are not among them."
      },
      "users": {
        "type": "integer",
        "minimum": 1,
        "description": "The members plus you, the count a per-user price reads."
      },
      "tztrack_tier": {
        "type": "string",
        "enum": [
          "introductory",
          "paid",
          "grace",
          "stopped",
          "free"
        ],
        "description": "Your account's tzTrack tier as the space's owner, after the call (ACB-L0-92). It is derived at the read, so an `add` that starts a payment grace says so. It is `introductory` while tzTrack's introductory period runs; after it, `paid`, `grace` for an account that must pay inside its payment grace, `stopped` once that grace has ended, or `free`."
      },
      "tztrack_grace_end": {
        "type": [
          "string",
          "null"
        ],
        "description": "The end of your account's, the owner's, tzTrack payment grace, ISO 8601, where one was written, and null otherwise (ACB-L0-92). Past it, an account that must pay and reads no paid tier reads `stopped`."
      }
    }
  }
}

Shared contracts #