View as Markdown

Default model tools

capture_session_create

Create a footage session

Creates a project-scoped Footage session for a bucket of recordings captured across one real-world period. The session starts without a master recording, reserves one stable editable episode handle, and can receive more files or device folders later. Local or contributor uploads join it through upload_link_create(capture_session_id: ...), and capture_session_read reports chronology analysis as it settles.

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": "capture_session_create",
  "title": "Create a footage session",
  "description": "Creates a project-scoped Footage session for a bucket of recordings captured across one real-world period. The session starts without a master recording, reserves one stable editable episode handle, and can receive more files or device folders later. Local or contributor uploads join it through upload_link_create(capture_session_id: ...), and capture_session_read reports chronology analysis as it settles.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID that owns the Footage session."
      },
      "title": {
        "type": "string",
        "description": "Short human title, such as Park coaching · Jul 15."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for safe retry of this exact creation request."
      }
    },
    "required": [
      "project_id",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create a footage session",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  }
}

App descriptor

{
  "name": "capture_session_create",
  "title": "Create a footage session",
  "description": "Creates a project-scoped Footage session for a bucket of recordings captured across one real-world period. The session starts without a master recording, reserves one stable editable episode handle, and can receive more files or device folders later. Local or contributor uploads join it through upload_link_create(capture_session_id: ...), and capture_session_read reports chronology analysis as it settles.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID that owns the Footage session."
      },
      "title": {
        "type": "string",
        "description": "Short human title, such as Park coaching · Jul 15."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for safe retry of this exact creation request."
      }
    },
    "required": [
      "project_id",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create a footage session",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "model",
        "app"
      ]
    },
    "openai/widgetAccessible": true
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "capture_session_id": {
        "type": "string"
      },
      "episode_id": {
        "type": "string",
        "description": "Stable episode handle reserved for the eventual editable projection."
      },
      "project_id": {
        "type": "string"
      },
      "title": {
        "type": "string"
      },
      "status": {
        "type": "string"
      },
      "revision": {
        "type": "integer"
      },
      "already_applied": {
        "type": "boolean"
      },
      "next_action": {
        "type": "object"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Live Workspace descriptor

{
  "name": "capture_session_create",
  "title": "Create a footage session",
  "description": "Creates a project-scoped Footage session for a bucket of recordings captured across one real-world period. The session starts without a master recording, reserves one stable editable episode handle, and can receive more files or device folders later. Local or contributor uploads join it through upload_link_create(capture_session_id: ...), and capture_session_read reports chronology analysis as it settles.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Project public ID that owns the Footage session."
      },
      "title": {
        "type": "string",
        "description": "Short human title, such as Park coaching · Jul 15."
      },
      "idempotency_key": {
        "type": "string",
        "description": "Caller-stable key for safe retry of this exact creation request."
      }
    },
    "required": [
      "project_id",
      "idempotency_key"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create a footage session",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "capture_session_id": {
        "type": "string"
      },
      "episode_id": {
        "type": "string",
        "description": "Stable episode handle reserved for the eventual editable projection."
      },
      "project_id": {
        "type": "string"
      },
      "title": {
        "type": "string"
      },
      "status": {
        "type": "string"
      },
      "revision": {
        "type": "integer"
      },
      "already_applied": {
        "type": "boolean"
      },
      "next_action": {
        "type": "object"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}

Errors

[
  "project_not_found",
  "idempotency_conflict",
  "invalid_input"
]

Examples

[]