Skip to main content
Glama

Influence

Start a media upload

mediaUploadCreate
Idempotent

Authorizes an exact file once using ordered part checksums. For batches, prepare and confirm each file before preparing the next; preparations can expire. Choose 64 MiB parts for new videos; 8 MiB is the default. Accepts supported images up to 20 MiB and MP4, MOV, WebM or M4V videos in standard dynamic range (SDR). MOV/WebM/M4V and video conversion support up to 250 MiB. Ready H.264/AAC MP4 supports up to 5 GB; destination limits still apply (YouTube 5 GB, other platforms up to 1 GB or their tighter limit). Returns the first batch of signed PUT URLs. Transfer parts directly to storage with Content-MD5, request nextPart only when needed, then finish without another confirmation. Reuse clientKey, partSizeBytes and identical checksums to resume. Uploads last 24 hours; URLs can be renewed. No file bytes in tool arguments.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYes
clientKeyYes
sizeBytesYes
contentTypeYes
partChecksumsYesOrdered base64 MD5 digests using partSizeBytes (8 MiB by default); the last part may be smaller. Binds confirmation to the exact file bytes.
partSizeBytesNoDefaults to 8388608 (8 MiB). For a new video upload, choose 67108864 (64 MiB) to reduce tool calls. Keep the same part size and clientKey on retries.
_idempotencyKeyNoCaller-generated retry ID for this confirmed request. Reuse the same value, confirmation capability and inputs when retrying an uncertain result.
_confirmationCapabilityNoOpaque preparation capability bound to this tool, its prepared input, connection, workspace and expiry. The publish_confirm_v1 prefix identifies the shared confirmation protocol.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "nextPart": {
      -                "anyOf": [
      -                  {
      -                    "$ref": "#/$defs/__schema0"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "partCount": {
      -                "maximum": 597,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "parts": {
      -                "items": {
      -                  "$ref": "#/$defs/__schema1"
      -                },
      -                "maxItems": 32,
      -                "type": "array"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "nextPart",
      -              "parts",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "AI_SCHEDULING_LIMIT_REACHED",
      -                  "AI_SCHEDULING_UNAVAILABLE",
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "description": "Opaque capability bound to the prepared toolName, inputDigest, connection, workspace and expiresAt. The publish_confirm_v1 prefix identifies the shared confirmation protocol.",
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema2"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "description": "Current upload or processing deadline. It can change during completion; ready media stays in the library.",
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "nextPart": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/__schema0"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "partCount": {
      +                "maximum": 597,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "parts": {
      +                "items": {
      +                  "$ref": "#/$defs/__schema1"
      +                },
      +                "maxItems": 32,
      +                "type": "array"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "nextPart",
      +              "parts",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "AI_SCHEDULING_LIMIT_REACHED",
      +                  "AI_SCHEDULING_UNAVAILABLE",
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Opaque capability bound to the prepared toolName, inputDigest, connection, workspace and expiresAt. The publish_confirm_v1 prefix identifies the shared confirmation protocol.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • changedInput schema / properties / partChecksums / description
      Previous value: -"Ordered base64 MD5 digests of each 8 MiB part; the last part may be smaller. Binds confirmation to the exact file bytes."New value: +"Ordered base64 MD5 digests using partSizeBytes (8 MiB by default); the last part may be smaller. Binds confirmation to the exact file bytes."
    • addedInput schema / properties / partSizeBytes
      Added value: +{
      +  "anyOf": [
      +    {
      +      "const": 8388608,
      +      "type": "number"
      +    },
      +    {
      +      "const": 67108864,
      +      "type": "number"
      +    }
      +  ],
      +  "description": "Defaults to 8388608 (8 MiB). For a new video upload, choose 67108864 (64 MiB) to reduce tool calls. Keep the same part size and clientKey on retries."
      +}
  3. Changed2 schema fields changed
    • changedInput schema / properties / _confirmationCapability / description
      Previous value: -"Value issued by Influence in this tool's preparation result. Return it unchanged before expiresAt to permit one execution of the prepared action. Never invent it; it is not an account credential or proof of human approval."New value: +"Opaque preparation capability bound to this tool, its prepared input, connection, workspace and expiry. The publish_confirm_v1 prefix identifies the shared confirmation protocol."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "nextPart": {
      -                "anyOf": [
      -                  {
      -                    "$ref": "#/$defs/__schema0"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "partCount": {
      -                "maximum": 597,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "parts": {
      -                "items": {
      -                  "$ref": "#/$defs/__schema1"
      -                },
      -                "maxItems": 32,
      -                "type": "array"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "nextPart",
      -              "parts",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "AI_SCHEDULING_LIMIT_REACHED",
      -                  "AI_SCHEDULING_UNAVAILABLE",
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema2"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "nextPart": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/__schema0"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "partCount": {
      +                "maximum": 597,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "parts": {
      +                "items": {
      +                  "$ref": "#/$defs/__schema1"
      +                },
      +                "maxItems": 32,
      +                "type": "array"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "nextPart",
      +              "parts",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "AI_SCHEDULING_LIMIT_REACHED",
      +                  "AI_SCHEDULING_UNAVAILABLE",
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Opaque capability bound to the prepared toolName, inputDigest, connection, workspace and expiresAt. The publish_confirm_v1 prefix identifies the shared confirmation protocol.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  4. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "nextPart": {
      -                "anyOf": [
      -                  {
      -                    "$ref": "#/$defs/__schema0"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "partCount": {
      -                "maximum": 597,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "parts": {
      -                "items": {
      -                  "$ref": "#/$defs/__schema1"
      -                },
      -                "maxItems": 32,
      -                "type": "array"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 5000000000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "nextPart",
      -              "parts",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema2"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "nextPart": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/__schema0"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "partCount": {
      +                "maximum": 597,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "parts": {
      +                "items": {
      +                  "$ref": "#/$defs/__schema1"
      +                },
      +                "maxItems": 32,
      +                "type": "array"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "nextPart",
      +              "parts",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "AI_SCHEDULING_LIMIT_REACHED",
      +                  "AI_SCHEDULING_UNAVAILABLE",
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. Changed16 schema fields changed
    • addedInput schema / properties / partChecksums
      Added value: +{
      +  "description": "Ordered base64 MD5 digests of each 8 MiB part; the last part may be smaller. Binds confirmation to the exact file bytes.",
      +  "items": {
      +    "pattern": "^[A-Za-z0-9+/]{21}[AQgw]==$",
      +    "type": "string"
      +  },
      +  "maxItems": 597,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • changedInput schema / properties / sizeBytes / maximum
      Previous value: -262144000New value: +5000000000
    • changedInput schema / required
      Previous value: -[
      -  "clientKey",
      -  "contentType",
      -  "name",
      -  "sizeBytes"
      -]New value: +[
      +  "clientKey",
      +  "contentType",
      +  "name",
      +  "partChecksums",
      +  "sizeBytes"
      +]
    • removedOutput schema / $defs / __schema0 / anyOf
      Removed value: -[
      -  {
      -    "maxLength": 8192,
      -    "type": "string"
      -  },
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "boolean"
      -  },
      -  {
      -    "type": "null"
      -  },
      -  {
      -    "items": {
      -      "$ref": "#/$defs/__schema0"
      -    },
      -    "maxItems": 512,
      -    "type": "array"
      -  },
      -  {
      -    "additionalProperties": {
      -      "$ref": "#/$defs/__schema0"
      -    },
      -    "propertyNames": {
      -      "$ref": "#/$defs/__schema1"
      -    },
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / $defs / __schema0 / maximum
      Added value: +597
    • addedOutput schema / $defs / __schema0 / minimum
      Added value: +1
    • addedOutput schema / $defs / __schema0 / type
      Added value: +"integer"
    • addedOutput schema / $defs / __schema1 / additionalProperties
      Added value: +false
    • removedOutput schema / $defs / __schema1 / maxLength
      Removed value: -128
    • removedOutput schema / $defs / __schema1 / minLength
      Removed value: -1
    • addedOutput schema / $defs / __schema1 / properties
      Added value: +{
      +  "contentMd5Base64": {
      +    "pattern": "^[A-Za-z0-9+/]{21}[AQgw]==$",
      +    "type": "string"
      +  },
      +  "expiresAt": {
      +    "maximum": 9007199254740991,
      +    "minimum": 0,
      +    "type": "integer"
      +  },
      +  "method": {
      +    "const": "PUT",
      +    "type": "string"
      +  },
      +  "partNumber": {
      +    "$ref": "#/$defs/__schema0"
      +  },
      +  "url": {
      +    "format": "uri",
      +    "maxLength": 4096,
      +    "type": "string"
      +  }
      +}
    • addedOutput schema / $defs / __schema1 / required
      Added value: +[
      +  "contentMd5Base64",
      +  "expiresAt",
      +  "method",
      +  "partNumber",
      +  "url"
      +]
    • changedOutput schema / $defs / __schema1 / type
      Previous value: -"string"New value: +"object"
    • addedOutput schema / $defs / __schema2
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 8192,
      +      "type": "string"
      +    },
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    },
      +    {
      +      "items": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "maxItems": 2000,
      +      "type": "array"
      +    },
      +    {
      +      "additionalProperties": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "propertyNames": {
      +        "$ref": "#/$defs/__schema3"
      +      },
      +      "type": "object"
      +    }
      +  ]
      +}
    • addedOutput schema / $defs / __schema3
      Added value: +{
      +  "maxLength": 128,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "partCount": {
      -                "maximum": 32,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema0"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "nextPart": {
      +                "anyOf": [
      +                  {
      +                    "$ref": "#/$defs/__schema0"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "partCount": {
      +                "maximum": 597,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "parts": {
      +                "items": {
      +                  "$ref": "#/$defs/__schema1"
      +                },
      +                "maxItems": 32,
      +                "type": "array"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 5000000000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "nextPart",
      +              "parts",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema2"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. Changed2 schema fields changed
    • changedInput schema / properties / _confirmationCapability / description
      Previous value: -"Value issued by Influence in this tool's preparation result. Return it unchanged with the exact same inputs before expiresAt to permit one execution. Never invent it; it is not an account credential or proof of human approval."New value: +"Value issued by Influence in this tool's preparation result. Return it unchanged before expiresAt to permit one execution of the prepared action. Never invent it; it is not an account credential or proof of human approval."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "partCount": {
      -                "maximum": 32,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability with the exact same tool inputs before expiresAt; never invent or modify it.",
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema0"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 262144000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "partCount": {
      +                "maximum": 32,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 262144000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability before expiresAt to confirm this prepared action; never invent or modify it.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema0"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  7. Changed3 schema fields changed
    • changedInput schema / properties / _confirmationCapability / description
      Previous value: -"Single-use from prepare."New value: +"Value issued by Influence in this tool's preparation result. Return it unchanged with the exact same inputs before expiresAt to permit one execution. Never invent it; it is not an account credential or proof of human approval."
    • changedInput schema / properties / _idempotencyKey / description
      Previous value: -"Caller-generated."New value: +"Caller-generated retry ID for this confirmed request. Reuse the same value, confirmation capability and inputs when retrying an uncertain result."
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "oneOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "ok": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "output": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "contentType": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "expiresAt": {
      -                "maximum": 9007199254740991,
      -                "minimum": 0,
      -                "type": "integer"
      -              },
      -              "maxSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "name": {
      -                "maxLength": 1024,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "partCount": {
      -                "maximum": 32,
      -                "minimum": 1,
      -                "type": "integer"
      -              },
      -              "partSizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 9007199254740991,
      -                "type": "integer"
      -              },
      -              "sizeBytes": {
      -                "exclusiveMinimum": 0,
      -                "maximum": 262144000,
      -                "type": "integer"
      -              },
      -              "uploadId": {
      -                "maxLength": 128,
      -                "minLength": 1,
      -                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "contentType",
      -              "expiresAt",
      -              "name",
      -              "partCount",
      -              "partSizeBytes",
      -              "sizeBytes",
      -              "uploadId",
      -              "maxSizeBytes"
      -            ],
      -            "type": "object"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "ok",
      -          "output",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "error": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "code": {
      -                "enum": [
      -                  "INVALID_INPUT",
      -                  "FORBIDDEN",
      -                  "NOT_FOUND",
      -                  "CONFLICT",
      -                  "FEATURE_DISABLED",
      -                  "CONFIRMATION_REQUIRED",
      -                  "CONFIRMATION_INVALID",
      -                  "UPSTREAM_FAILED",
      -                  "NEEDS_REVIEW",
      -                  "INTERNAL"
      -                ],
      -                "type": "string"
      -              },
      -              "message": {
      -                "maxLength": 2048,
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "retryable": {
      -                "type": "boolean"
      -              }
      -            },
      -            "required": [
      -              "code",
      -              "message",
      -              "retryable"
      -            ],
      -            "type": "object"
      -          },
      -          "ok": {
      -            "const": false,
      -            "type": "boolean"
      -          },
      -          "toolName": {
      -            "const": "mediaUploadCreate",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "error",
      -          "ok",
      -          "toolName"
      -        ],
      -        "type": "object"
      -      }
      -    ]
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "confirmationCapability": {
      -        "maxLength": 4096,
      -        "minLength": 32,
      -        "pattern": "^[A-Za-z0-9._~-]+$",
      -        "type": "string"
      -      },
      -      "expiresAt": {
      -        "format": "date-time",
      -        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -        "type": "string"
      -      },
      -      "inputDigest": {
      -        "pattern": "^[0-9a-f]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "confirmation_required",
      -        "type": "string"
      -      },
      -      "summary": {
      -        "$ref": "#/$defs/__schema0"
      -      },
      -      "toolName": {
      -        "const": "mediaUploadCreate",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "confirmationCapability",
      -      "expiresAt",
      -      "inputDigest",
      -      "status",
      -      "toolName"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "ok": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "output": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "contentType": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "expiresAt": {
      +                "maximum": 9007199254740991,
      +                "minimum": 0,
      +                "type": "integer"
      +              },
      +              "maxSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 262144000,
      +                "type": "integer"
      +              },
      +              "name": {
      +                "maxLength": 1024,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "partCount": {
      +                "maximum": 32,
      +                "minimum": 1,
      +                "type": "integer"
      +              },
      +              "partSizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 9007199254740991,
      +                "type": "integer"
      +              },
      +              "sizeBytes": {
      +                "exclusiveMinimum": 0,
      +                "maximum": 262144000,
      +                "type": "integer"
      +              },
      +              "uploadId": {
      +                "maxLength": 128,
      +                "minLength": 1,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "contentType",
      +              "expiresAt",
      +              "name",
      +              "partCount",
      +              "partSizeBytes",
      +              "sizeBytes",
      +              "uploadId",
      +              "maxSizeBytes"
      +            ],
      +            "type": "object"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ok",
      +          "output",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "additionalProperties": false,
      +        "properties": {
      +          "error": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "code": {
      +                "enum": [
      +                  "INVALID_INPUT",
      +                  "FORBIDDEN",
      +                  "NOT_FOUND",
      +                  "CONFLICT",
      +                  "FEATURE_DISABLED",
      +                  "CONFIRMATION_REQUIRED",
      +                  "CONFIRMATION_INVALID",
      +                  "UPSTREAM_FAILED",
      +                  "NEEDS_REVIEW",
      +                  "INTERNAL"
      +                ],
      +                "type": "string"
      +              },
      +              "message": {
      +                "maxLength": 2048,
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "retryable": {
      +                "type": "boolean"
      +              }
      +            },
      +            "required": [
      +              "code",
      +              "message",
      +              "retryable"
      +            ],
      +            "type": "object"
      +          },
      +          "ok": {
      +            "const": false,
      +            "type": "boolean"
      +          },
      +          "toolName": {
      +            "const": "mediaUploadCreate",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "error",
      +          "ok",
      +          "toolName"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "confirmationCapability": {
      +        "description": "Issued by Influence for this preparation. Return it unchanged as _confirmationCapability with the exact same tool inputs before expiresAt; never invent or modify it.",
      +        "maxLength": 4096,
      +        "minLength": 32,
      +        "pattern": "^[A-Za-z0-9._~-]+$",
      +        "type": "string"
      +      },
      +      "expiresAt": {
      +        "format": "date-time",
      +        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +        "type": "string"
      +      },
      +      "inputDigest": {
      +        "pattern": "^[0-9a-f]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "confirmation_required",
      +        "type": "string"
      +      },
      +      "summary": {
      +        "$ref": "#/$defs/__schema0"
      +      },
      +      "toolName": {
      +        "const": "mediaUploadCreate",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "confirmationCapability",
      +      "expiresAt",
      +      "inputDigest",
      +      "status",
      +      "toolName"
      +    ],
      +    "type": "object"
      +  }
      +]
  8. Added

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (idempotent, openWorld, non-destructive), it discloses critical behavior: 24-hour upload lifetime with renewable URLs, expiring preparations, no file bytes in tool arguments (direct-to-storage transfer with Content-MD5), and per-format size ceilings (20 MiB images, 250 MiB MOV/WebM/M4V, 5 GB MP4, platform limits). This is far more than the annotations convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is a single dense, front-loaded paragraph where nearly every sentence carries actionable constraint (sizes, expiry, resume, transfer method). It borders on over-packed but avoids filler; a light bullet structure would improve scanability without changing content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite an output schema existing, the description still frames the return (first batch of signed PUT URLs) and covers the full lifecycle: expiry, renewal, resumption, batching, transfer mechanics, and destination limits. An agent has everything needed to invoke and sequence it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 50% schema coverage, the description meaningfully augments the undocumented parameters: it ties partSizeBytes to the 64 MiB vs 8 MiB tradeoff, explains clientKey reuse for resumption, and maps contentType/sizeBytes to concrete format and size limits. It adds real semantics, though 'name' remains unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action and resource — authorizing an exact file via ordered part checksums and returning signed PUT URLs — which is clearly the 'start/reserve' step of a multi-step upload flow. This distinguishes it from siblings like mediaUploadPart, mediaUploadComplete, and mediaUploadAbort without needing to open their schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete operational guidance: prepare and confirm each file before the next in batches, choose 64 MiB parts for new videos vs the 8 MiB default, call nextPart only when needed, and reuse clientKey/partSizeBytes/checksums to resume. It stops short of naming sibling tools by name, so an agent must infer that 'request nextPart' means mediaUploadPart, but the context is otherwise clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources