View as Markdown

Default model tools

project_participants_mutate

Save participant recognition and reviews

Studio-owner operation for Project-scoped face recognition. enable requires explicit participant permission and expected_consent_revision from a fresh read; recording_ids selects up to eight historical Recordings, while enabled future intake is automatic. process selects further existing Recordings. review names/confirms only explicitly included displayed observation IDs and excludes the displayed examples that are not that person; it takes the exact review_context and either speaker_profile_id OR new_person_name, and project_participants_read reports the cached-descriptor regrouping that follows. reviewer_kind:delegated_agent_review records a review made under delegated authority, which is distinct from the owner personally inspecting the images. undo requires the current review_id and refuses to overwrite newer answers. disable stops use/work while retaining saved data. forget disables and removes this feature's Project descriptors, previews and associations; Recordings, voices, approved portraits and a host's confirmed face references remain. retry names a failed recording_id or job_id. review, undo, and update_matches accept match_scope with type episode plus episode_id, type recordings plus up to eight recording_ids, or type project. Omission retains the Project-wide default for existing clients. update_matches only uses cached descriptors and never analyzes original video; unavailable evidence is reported separately. Deferred Recordings retain reviewed facts while older automatic names are withheld. cancel_update with job_id stops a cached update and retains the saved answer; retry reuses that job scope. Every action requires a stable idempotency_key. Participant permission is explicit per Project: consent here gates only this Project's matching and enables no other Project, and a host's confirmed faces stay theirs whether it is on or off.

Surface: Default model and app

Product release 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Captured 2026-10-29T03:35:56.855Z. Review or improve this contract on GitHub.

These blocks show the complete MCP descriptors captured from serving Rails. Security schemes and resource URIs can differ by connected host.

Default model descriptor

{
  "name": "project_participants_mutate",
  "title": "Save participant recognition and reviews",
  "description": "Studio-owner operation for Project-scoped face recognition. enable requires explicit participant permission and expected_consent_revision from a fresh read; recording_ids selects up to eight historical Recordings, while enabled future intake is automatic. process selects further existing Recordings. review names/confirms only explicitly included displayed observation IDs and excludes the displayed examples that are not that person; it takes the exact review_context and either speaker_profile_id OR new_person_name, and project_participants_read reports the cached-descriptor regrouping that follows. reviewer_kind:delegated_agent_review records a review made under delegated authority, which is distinct from the owner personally inspecting the images. undo requires the current review_id and refuses to overwrite newer answers. disable stops use/work while retaining saved data. forget disables and removes this feature's Project descriptors, previews and associations; Recordings, voices, approved portraits and a host's confirmed face references remain. retry names a failed recording_id or job_id. review, undo, and update_matches accept match_scope with type episode plus episode_id, type recordings plus up to eight recording_ids, or type project. Omission retains the Project-wide default for existing clients. update_matches only uses cached descriptors and never analyzes original video; unavailable evidence is reported separately. Deferred Recordings retain reviewed facts while older automatic names are withheld. cancel_update with job_id stops a cached update and retains the saved answer; retry reuses that job scope. Every action requires a stable idempotency_key. Participant permission is explicit per Project: consent here gates only this Project's matching and enables no other Project, and a host's confirmed faces stay theirs whether it is on or off.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      },
      "action": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "enable",
              "process",
              "review",
              "undo",
              "disable",
              "forget",
              "retry",
              "update_matches",
              "cancel_update"
            ]
          },
          "expected_consent_revision": {
            "type": "integer",
            "minimum": 0
          },
          "participant_permission": {
            "type": "boolean"
          },
          "recording_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "uniqueItems": true
          },
          "review_context": {
            "type": "string"
          },
          "included_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "excluded_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "speaker_profile_id": {
            "type": "string"
          },
          "new_person_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "reviewer_kind": {
            "type": "string",
            "enum": [
              "owner_review",
              "delegated_agent_review"
            ]
          },
          "match_scope": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "episode",
                  "project",
                  "recordings"
                ]
              },
              "episode_id": {
                "type": "string"
              },
              "recording_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 8,
                "uniqueItems": true
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          },
          "review_id": {
            "type": "string"
          },
          "job_id": {
            "type": "string"
          },
          "recording_id": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "project_id",
      "idempotency_key",
      "action"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Save participant recognition and reviews",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "project_participants_mutate",
  "title": "Save participant recognition and reviews",
  "description": "Studio-owner operation for Project-scoped face recognition. enable requires explicit participant permission and expected_consent_revision from a fresh read; recording_ids selects up to eight historical Recordings, while enabled future intake is automatic. process selects further existing Recordings. review names/confirms only explicitly included displayed observation IDs and excludes the displayed examples that are not that person; it takes the exact review_context and either speaker_profile_id OR new_person_name, and project_participants_read reports the cached-descriptor regrouping that follows. reviewer_kind:delegated_agent_review records a review made under delegated authority, which is distinct from the owner personally inspecting the images. undo requires the current review_id and refuses to overwrite newer answers. disable stops use/work while retaining saved data. forget disables and removes this feature's Project descriptors, previews and associations; Recordings, voices, approved portraits and a host's confirmed face references remain. retry names a failed recording_id or job_id. review, undo, and update_matches accept match_scope with type episode plus episode_id, type recordings plus up to eight recording_ids, or type project. Omission retains the Project-wide default for existing clients. update_matches only uses cached descriptors and never analyzes original video; unavailable evidence is reported separately. Deferred Recordings retain reviewed facts while older automatic names are withheld. cancel_update with job_id stops a cached update and retains the saved answer; retry reuses that job scope. Every action requires a stable idempotency_key. Participant permission is explicit per Project: consent here gates only this Project's matching and enables no other Project, and a host's confirmed faces stay theirs whether it is on or off.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      },
      "action": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "enable",
              "process",
              "review",
              "undo",
              "disable",
              "forget",
              "retry",
              "update_matches",
              "cancel_update"
            ]
          },
          "expected_consent_revision": {
            "type": "integer",
            "minimum": 0
          },
          "participant_permission": {
            "type": "boolean"
          },
          "recording_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "uniqueItems": true
          },
          "review_context": {
            "type": "string"
          },
          "included_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "excluded_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "speaker_profile_id": {
            "type": "string"
          },
          "new_person_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "reviewer_kind": {
            "type": "string",
            "enum": [
              "owner_review",
              "delegated_agent_review"
            ]
          },
          "match_scope": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "episode",
                  "project",
                  "recordings"
                ]
              },
              "episode_id": {
                "type": "string"
              },
              "recording_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 8,
                "uniqueItems": true
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          },
          "review_id": {
            "type": "string"
          },
          "job_id": {
            "type": "string"
          },
          "recording_id": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "project_id",
      "idempotency_key",
      "action"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Save participant recognition and reviews",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

Live Workspace descriptor

{
  "name": "project_participants_mutate",
  "title": "Save participant recognition and reviews",
  "description": "Studio-owner operation for Project-scoped face recognition. enable requires explicit participant permission and expected_consent_revision from a fresh read; recording_ids selects up to eight historical Recordings, while enabled future intake is automatic. process selects further existing Recordings. review names/confirms only explicitly included displayed observation IDs and excludes the displayed examples that are not that person; it takes the exact review_context and either speaker_profile_id OR new_person_name, and project_participants_read reports the cached-descriptor regrouping that follows. reviewer_kind:delegated_agent_review records a review made under delegated authority, which is distinct from the owner personally inspecting the images. undo requires the current review_id and refuses to overwrite newer answers. disable stops use/work while retaining saved data. forget disables and removes this feature's Project descriptors, previews and associations; Recordings, voices, approved portraits and a host's confirmed face references remain. retry names a failed recording_id or job_id. review, undo, and update_matches accept match_scope with type episode plus episode_id, type recordings plus up to eight recording_ids, or type project. Omission retains the Project-wide default for existing clients. update_matches only uses cached descriptors and never analyzes original video; unavailable evidence is reported separately. Deferred Recordings retain reviewed facts while older automatic names are withheld. cancel_update with job_id stops a cached update and retains the saved answer; retry reuses that job scope. Every action requires a stable idempotency_key. Participant permission is explicit per Project: consent here gates only this Project's matching and enables no other Project, and a host's confirmed faces stay theirs whether it is on or off.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string"
      },
      "idempotency_key": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      },
      "action": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "enable",
              "process",
              "review",
              "undo",
              "disable",
              "forget",
              "retry",
              "update_matches",
              "cancel_update"
            ]
          },
          "expected_consent_revision": {
            "type": "integer",
            "minimum": 0
          },
          "participant_permission": {
            "type": "boolean"
          },
          "recording_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "uniqueItems": true
          },
          "review_context": {
            "type": "string"
          },
          "included_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "excluded_observation_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6,
            "uniqueItems": true
          },
          "speaker_profile_id": {
            "type": "string"
          },
          "new_person_name": {
            "type": "string",
            "minLength": 1,
            "maxLength": 120
          },
          "reviewer_kind": {
            "type": "string",
            "enum": [
              "owner_review",
              "delegated_agent_review"
            ]
          },
          "match_scope": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "episode",
                  "project",
                  "recordings"
                ]
              },
              "episode_id": {
                "type": "string"
              },
              "recording_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "maxItems": 8,
                "uniqueItems": true
              }
            },
            "required": [
              "type"
            ],
            "additionalProperties": false
          },
          "review_id": {
            "type": "string"
          },
          "job_id": {
            "type": "string"
          },
          "recording_id": {
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      }
    },
    "required": [
      "project_id",
      "idempotency_key",
      "action"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Save participant recognition and reviews",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  }
}

Errors

[
  "not_found",
  "invalid_input",
  "recognition_owner_required",
  "recognition_review_stale",
  "recognition_undo_stale",
  "recognition_consent_changed",
  "recognition_retry_changed"
]

Examples

[]