SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Tasks

Create a project. The member behind the key must be allowed to plan projects

POSThttps://app.softsolz.uk/api/v1/services/tasks/projects

Recent Requests

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

Headers

Authorizationstringrequired

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

Body Params

namestringrequired

Up to 160 characters.

descriptionstring | null

Up to 5000 characters.

statusstring

One of planned, active, on_hold, done, cancelled.

owner_user_idinteger | null

Member who owns it.

org_unit_idinteger | null

Department or location.

starts_onstring | null

Start date.

due_onstring | null

Due date.

colourstring | null

A colour name like blue.

Response

Response Body

idintegerProject id.
namestringProject name.
descriptionstring | nullWhat the project is about.
statusstringWhere the project is.
ownerobject | nullMember who owns the project.
org_unitobject | nullDepartment or location, or null when there is none.
starts_onstring | nullWhen it starts.
due_onstring | nullWhen it is due.
colourstring | nullColour name.
progressobjectHow many of its tasks are done.
milestone_countintegerHow many milestones it has.
next_milestoneobject | nullThe next open milestone.
updated_atstringLast change.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/tasks/projects \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "New store opening",
"due_on": "2027-03-01"
}'

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": 2,
"name": "New store opening",
"description": "your-description",
"status": "your-status",
"owner": {
"id": 12,
"name": "Sam Lee"
},
"org_unit": {
"id": 1,
"name": "your-name"
},
"starts_on": "2026-01-01",
"due_on": "2026-01-01",
"colour": "blue",
"progress": {
"done": 1,
"total": 1,
"percent": 1
},
"milestone_count": 1,
"next_milestone": {},
"updated_at": "2026-01-01T09:00:00.000Z"
}
}