Incorrect documentation regarding errors during files_batch* requests
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 45/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Tech stack
- python
- Domain
- documentation
Research direction
Start by locating the documentation for files_move_batch and files_move_batch_check, then verify the documented ApiError member and PollError module against the SDK behavior described. Done means the text names ApiError.error and dropbox.async.PollError consistently.
Written by the indexing model from the issue text.
Description
Hey there,
We're using files_move_batch and files_move_batch_check. Talking to support, they've acknowledge that transient errors can occur during either of these two calls requiring a nominal back-off retry. While try/excepting these conditions, the documentation says that ApiError.reason carries the domain-specific error and in our case the error would be dropbox.files.PollError.
Neither of these cases are accurate: ApiError.error contains the error (there is no 'reason' member) and dropbox.async.PollError was returned, not dropbox.files.PollError.
We're using dropbox 7.2.1 but I've just checked 7.3.1 docs and the inconsistency remains:
If this raises, ApiError.reason is of type:
dropbox.files.PollError
- Dominant language
- Python
- Stars
- 983
- Forks
- 331
- Avg merge
- 3m
- Merged PRs (30d)
- 10
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from dropbox/dropbox-sdk-python
-
question
Difficulty 4/5 3-5 days Newbie friendliness 35/100
dropbox/dropbox-sdk-python#585 · 4 comments ·
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 35/100
dropbox/dropbox-sdk-python#491 · 1 comment ·
-
enhancement
Difficulty 3/5 1-2 days Newbie friendliness 35/100
dropbox/dropbox-sdk-python#482 · 1 comment · 2 reactions ·
-
question
Difficulty 5/5 Over a week Newbie friendliness 25/100
dropbox/dropbox-sdk-python#476 · 3 comments ·
-
bug
Difficulty 5/5 Over a week Newbie friendliness 20/100
dropbox/dropbox-sdk-python#475 · 1 comment ·
All issues in dropbox/dropbox-sdk-python
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
anthropics/skills#1811 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
speaches-ai/speaches#678 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
datalayer/mcp-compose#42 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
conda-forge/spacy-feedstock#177 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
UKGovernmentBEIS/inspect_evals#2523 ·