Submit work. Creates the next attempt. A checklist line marked required must be ticked (checked_at set in checklist_state, or already ticked on the assignment) or the request is refused with 400 checklist_required, naming the line. Attach files either as multipart/form-data parts named "files", or in a JSON body as file_ids from POST /files or POST /files/upload-links
POST
https://app.softsolz.uk/api/v1/services/tasks/assignments/{id}/submitRecent Requests
Kept only in this browserTimeStatusTook
Send a request with Try it to see it here.
Path Params
idstringrequiredHeaders
AuthorizationstringrequiredBearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.
Body Params
notestringWhat the assignee wants the reviewer to know.
custom_fieldsobjectValues for the required fields.
checklist_statearray of objectsTicked steps, replacing the stored state.
file_idsarray of stringsFiles already sent with POST /files or POST /files/upload-links.
Response
Response Body
idintegerSubmission id.assignment_idintegerParent assignment.attempt_nointegerWhich attempt this is, starting at 1.notestring | nullWhat the assignee wrote.filesarray of objectsUploaded work.custom_fieldsobjectValues for form-mode submissions.is_latebooleanSubmitted after the deadline.submitted_atstringSubmission timestamp.Request
curl --request POST \ --url https://app.softsolz.uk/api/v1/services/tasks/assignments/{id}/submit \ --header 'Authorization: Bearer sk_live_your_key' \ --header 'Content-Type: application/json' \ --data '{ "note": "All floors done.", "custom_fields": {}, "checklist_state": [ { "id": "floor-1", "checked_at": "2026-09-01T10:00:00.000Z" } ]}'Credentials
Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.
Response · 201
{ "data": { "id": 5001, "assignment_id": 900, "attempt_no": 2, "note": "All floors done.", "files": [ { "filename": "report.pdf", "mime": "application/pdf", "size_bytes": 184320, "download_url": "https://s3.eu-west-2.amazonaws.com/...", "content_url": "/api/services/tasks/files/content?key=tasks%2F..." } ], "custom_fields": {}, "is_late": false, "submitted_at": "2026-09-02T08:00:00.000Z" }}