Add batch invocation API documentation #96
Conversation
Mesa DescriptionAdded comprehensive documentation for the new batch invocation API that allows developers to execute multiple function invocations in a single request. The documentation covers creating batch jobs, monitoring progress, and managing concurrent executions with proper error handling. Files changed:
Created by Mintlify agent Description generated by Mesa. Update settings |
![mesa-dot-dev[bot]](https://avatars.githubusercontent.com/in/1050077?s=60&v=4){kind=small}
There was a problem hiding this comment.
Performed full review of ab446d9...bfdca30
Analysis
-
API Naming Inconsistency: The batch API uses inconsistent naming patterns (
kernel.invocations.batch.create()vskernel.batchJobs.list()), potentially causing developer confusion and indicating underlying SDK design issues. -
Incomplete Error Handling Documentation: While batch jobs continue despite individual invocation failures, the documentation lacks examples for accessing specific error details from failed invocations.
-
Resource Management Gaps: Streaming examples don't demonstrate proper connection cleanup or error handling for SSE streams, which could lead to resource leaks.
-
Missing Edge Cases: Documentation doesn't address important scenarios like max_concurrency exceeding organization limits or how billing/rate limiting works with batch jobs.
Tip
Help
Slash Commands:
/review- Request a full code review/review latest- Review only changes since the last review/describe- Generate PR description. This will update the PR body or issue comment depending on your configuration/help- Get help with Mesa commands and configuration options
2 files reviewed | 0 comments | Edit Agent Settings
Added comprehensive documentation for the new batch invocation API that allows developers to execute multiple function invocations in a single request. The documentation covers creating batch jobs, monitoring progress, and managing concurrent executions with proper error handling.
Files changed:
apps/batching.mdx(new) - Complete batch API documentation with examplesdocs.json- Added batching page to App Platform navigationCreated by Mintlify agent