SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

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

POSThttps://app.softsolz.uk/api/v1/services/tasks/assignments/{id}/submit

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Body Params

notestring

What the assignee wants the reviewer to know.

custom_fieldsobject

Values for the required fields.

checklist_statearray of objects

Ticked steps, replacing the stored state.

file_idsarray of strings

Files 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"
}
}