Skip to content
getgeolens.com

Update Publication Status

PATCH
/datasets/{dataset_id}/status/
curl --request PATCH \
--url https://example.com/api/datasets/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/status/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "status": "example" }'

Transition a dataset’s publication status following allowed paths.

Allowed transitions: draft -> ready -> internal -> published (and back one step).

dataset_id
required
Dataset Id
string format: uuid
Media type application/json
StatusUpdate
object
status
required
Status
string
<= 20 characters
Example generated
{
"status": "example"
}

Successful Response

Media type application/json
StatusUpdateResponse
object
id
required
Id
string
record_status
required
Record Status
string
Example generated
{
"id": "example",
"record_status": "example"
}

Bad request — invalid payload

Unauthorized — missing or invalid credentials

Forbidden — caller lacks write access

Not found

Conflict — resource state prevents the operation

Validation error

Internal server error