get_status
Check the processing status and progress percentage of a short video creation request by providing the request ID.
Instructions
Check processing status and progress of a short creation request. Returns status (queued/processing/completed/failed), progress percentage, and current step.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| requestId | Yes | The request ID from create_short (24-char hex) |
Implementation Reference
- src/tools/get-status.js:13-20 (handler)The tool handler logic for 'get_status' which calls the Ssemble API client.
async ({ requestId }) => { try { const result = await client.getStatus(requestId); return { content: [{ type: 'text', text: formatStatusResponse(result) }] }; } catch (error) { return { content: [{ type: 'text', text: formatError(error) }], isError: true }; } } - src/tools/get-status.js:8-22 (registration)The registration function for the 'get_status' tool.
export function registerGetStatus(server, client) { server.tool( 'get_status', 'Check processing status and progress of a short creation request. Returns status (queued/processing/completed/failed), progress percentage, and current step.', schema, async ({ requestId }) => { try { const result = await client.getStatus(requestId); return { content: [{ type: 'text', text: formatStatusResponse(result) }] }; } catch (error) { return { content: [{ type: 'text', text: formatError(error) }], isError: true }; } } ); } - src/tools/get-status.js:4-6 (schema)Input validation schema for the 'get_status' tool.
const schema = { requestId: z.string().regex(/^[0-9a-fA-F]{24}$/).describe('The request ID from create_short (24-char hex)'), }; - src/api/client.js:104-107 (helper)The underlying API client method that performs the actual network request for 'get_status'.
// Endpoint 3: GET /shorts/:id/status async getStatus(requestId) { return this._request('GET', `/shorts/${requestId}/status`); }