Title98/100
Check Job Status
The title clearly communicates the tool’s action and subject. Keep it concise.
Description90/100
Poll an async move, copy, or delete operation REQUEST CONTRACT: - operation_id (required): the opaque token returned by an async mutation tool (for example, dropbox.move with status="in_progress"). - 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. - result_type: "move", "copy", or "delete". Selects which result field is populated. - One of move_result, copy_result, delete_result is populated when status="completed" (keyed by result_type). - Each successful result entry's object includes modified_time, which is the server-side modification time in ISO 8601 format when available. - Invalid/expired operation_id values and Dropbox poll failures are returned as tool errors. ASSISTANT POLICY: - Pass operation_id back verbatim. Do not alter, truncate, or encode/decode it. - recommended_poll_after_ms is advisory. This tool does not enforce a minimum poll interval, but polling faster may trigger RESOURCE_EXHAUSTED rate-limit errors. Respect the recommendation; do not poll in a tight loop. - When status becomes "completed", present the per-entry results from the selected *_result field. 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 schema50/100
Align the output schema with the tool’s documented 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
}