Skip to content

Create a goal pre-scoped to This Week or Next Week.

POST
/goals
curl --request POST \
--url https://api.gospl.example/v1/goals \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "title": "example", "description": "example", "type": "professional", "targetWeek": "this" }'
Media type application/json
object
title
required
string
>= 1 characters
description
string
type
required
string
Allowed values: professional personal
targetWeek
required

Only active columns accept new/moved goals; Previous is read-only.

string
Allowed values: this next

Created.

Media type application/json
object
id
required
string format: uuid
title
required
string
description
string
type
required
string
Allowed values: professional personal
status
required
string
Allowed values: active complete
weekStart
required

Anchors the goal to a week (G2).

string format: date
dateSet
required
string format: date-time
dateCompleted
string format: date-time
Example
{
"type": "professional",
"status": "active"
}

Invalid request.

Media type application/json
object
code
required
string
message
required
string
Example generated
{
"code": "example",
"message": "example"
}

Missing/invalid credentials.

Media type application/json
object
code
required
string
message
required
string
Example generated
{
"code": "example",
"message": "example"
}