Bugfix: Return created task ID when posting document to API

[stumpylog]

Proposed change

When posting a document, the response now includes the UUID of the created celery task. This can in turn be provided to the /api/tasks as a query parameter to get the status of the particular task.

Web UI uploads seemed fine, frontend task view also works are per normally. Only when exploring the API and providing the query parameter did this do anything (as expected)

Fixes #2278

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Other (please explain)

Checklist:

• I have read & agree with the contributing guidelines.
• If applicable, I have tested my code for new features & regressions on both mobile & desktop devices, using the latest version of major browsers.
• If applicable, I have checked that all tests pass, see documentation.
• I have run all pre-commit hooks, see documentation.
• I have made corresponding changes to the documentation as needed.
• I have checked my modifications for any breaking changes.

[shamoon]

Cool. I guess the only question is whether any existing apps are expecting the "OK" but hopefully theyre doing something more reliable like testing the HTTP status...

[christf]

I think this is a breaking change in the api. An existing value is being assigned a different/new meaning.

While at it, the return data could be turned into a JSON structure with explicit task id field, avoiding future breaking changes when adding different values.

[shamoon]

Yea agree, hence my comment above but hopefully most are using something more reliable such as http status.

We can mention this in the release notes, on balance, I think it’s useful

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new discussion or issue for related concerns.