Title99/100
Check Job Status
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Poll an async move, copy, delete, or restore_folder operation REQUEST CONTRACT: - operation_id (required): the opaque token returned by move, copy, delete, or restore_folder. - wait_ms (optional): wait budget in milliseconds. Omitted or 0 performs one immediate status check. Positive values ask the server to wait briefly for completion. Maximum 30000ms; values >30000 or negative are rejected with INVALID_WAIT_MS. RESPONSE CONTRACT: - status: "completed" or "in_progress". - operation_id: echoed when status="in_progress". Pass it back unchanged for the next poll. - recommended_poll_after_ms: suggested delay before the next poll. - When status="completed", result_type and the populated result field are: - result_type="move" with move_result. - result_type="copy" with copy_result. - result_type="delete" with delete_result. - result_type="restore_folder" with restore_folder_result. - Successful move, copy, and delete result entries include an object with modified_time, which is the server-side modification time in ISO 8601 format when available. ASSISTANT POLICY: - Use this tool only when move, copy, delete, or restore_folder returns an operation_id. - Do not assume every async Fileverse MCP tool uses check_job_status. Follow the submission tool's polling instructions. - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - Respect recommended_poll_after_ms; do not poll in a tight loop. - When status becomes "completed", read result_type and use the matching result field listed above. - Follow the submission tool's instructions for operation-specific results, errors, retries, and user-facing guidance. EXAMPLES: {"operation_id": "<token from previous in_progress response>"} {"operation_id": "<token>", "wait_ms": 5000}
The description explains the capability, when to use it, and what to expect.
Inputs0/100
0 of 2 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
operation_id
Not provided
Missing description. Explain what this value means and how to supply it.
wait_ms
Not provided
Missing description. Explain what this value means and how to supply it.
Annotations100/100
All four behavior hints are declared.
{
"title": "Check Job Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema46/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string"
},
"failure": {
"type": [
"null",
"object"
],
"properties": {
"message": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"additionalProperties": false
},
"copy_result": {
"type": [
"null",
"object"
],
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": [
"null",
"object"
],
"required": [
"entry_index",
"entry_status"
],
"properties": {
"object": {
"type": [
"null",
"object"
],
"properties": {
"file": {
"type": [
"null",
"object"
],
"properties": {
"size": {
"type": "integer"
}
},
"additionalProperties": false
},
"name": {
"type": "string"
},
"path": {
"type": "string"
},
"mount": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"folder": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"file_id": {
"type": "string"
},
"object_type": {
"type": "string"
},
"path_display": {
"type": "string"
},
"modified_time": {
"type": "string"
},
"client_modified": {
"type": "string"
}
},
"additionalProperties": false
},
"failure": {
"type": [
"null",
"object"
],
"properties": {
"message": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"additionalProperties": false
},
"entry_index": {
"type": "integer"
},
"entry_status": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"move_result": {
"type": [
"null",
"object"
],
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": [
"null",
"object"
],
"required": [
"entry_index",
"entry_status"
],
"properties": {
"object": {
"type": [
"null",
"object"
],
"properties": {
"file": {
"type": [
"null",
"object"
],
"properties": {
"size": {
"type": "integer"
}
},
"additionalProperties": false
},
"name": {
"type": "string"
},
"path": {
"type": "string"
},
"mount": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"folder": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"file_id": {
"type": "string"
},
"object_type": {
"type": "string"
},
"path_display": {
"type": "string"
},
"modified_time": {
"type": "string"
},
"client_modified": {
"type": "string"
}
},
"additionalProperties": false
},
"failure": {
"type": [
"null",
"object"
],
"properties": {
"message": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"additionalProperties": false
},
"entry_index": {
"type": "integer"
},
"entry_status": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"result_type": {
"type": "string"
},
"operation_id": {
"type": "string"
},
"delete_result": {
"type": [
"null",
"object"
],
"required": [
"entries"
],
"properties": {
"entries": {
"type": "array",
"items": {
"type": [
"null",
"object"
],
"required": [
"entry_index",
"entry_status"
],
"properties": {
"object": {
"type": [
"null",
"object"
],
"properties": {
"file": {
"type": [
"null",
"object"
],
"properties": {
"size": {
"type": "integer"
}
},
"additionalProperties": false
},
"name": {
"type": "string"
},
"path": {
"type": "string"
},
"mount": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"folder": {
"type": [
"null",
"object"
],
"additionalProperties": false
},
"file_id": {
"type": "string"
},
"object_type": {
"type": "string"
},
"path_display": {
"type": "string"
},
"modified_time": {
"type": "string"
},
"client_modified": {
"type": "string"
}
},
"additionalProperties": false
},
"failure": {
"type": [
"null",
"object"
],
"properties": {
"message": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"additionalProperties": false
},
"entry_index": {
"type": "integer"
},
"entry_status": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"restore_folder_result": {
"type": [
"null",
"object"
],
"properties": {
"path": {
"type": "string"
},
"is_team": {
"type": "boolean"
},
"num_files": {
"type": "integer"
},
"num_folders": {
"type": "integer"
},
"target_ts_microseconds": {
"type": "integer"
}
},
"additionalProperties": false
},
"recommended_poll_after_ms": {
"type": "integer"
}
},
"additionalProperties": false
}