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 eb8538f4a297f331d0399351c1e175bffcd212d2
Public contract commit 20688e11af473a363145ed880d5019c90a7ec1e2
Public contract SHA-256 87a94b85a84dc19245fc03f9b544c70d64bd9f5e08585dcccb38157cace5700d
Captured 2026-10-04T11:55:45.577Z. 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

[]