Skip to content
Optiwork API Docs

Make a world the live one

POST
/spaces/maps/{map}/activation
curl --request POST \
  --url https://spaces.work.optidata.cloud/api/spaces/maps/a28e5bf3-26b4-4a34-9f98-9a116a2700ca/activation \
  --header 'Authorization: Bearer <token>'

Makes this world the one every space of the company is laid out from. The previously active world goes back to being a draft; its identifier is returned in deactivated_identifier. People already inside a space see the new world when the space reloads. Activating the world that is already active changes nothing (deactivated_identifier: null).

Company super-administrators only.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
map
required
string

The world’s identifier.

Responses

Section titled “ Responses ”

200

Section titled “200”

The world is now active.

Media typeapplication/json
object
map
required
object
identifier
required
string
name
required
string
source_map

The world this one was copied from, if any.

string | null
status
required
string
Allowed values: draft active
is_active
required
boolean
version
required

Grows with every saved change.

integer
activated_at
string | null format: date-time
created_by_uuid
string | null
updated_by_uuid
string | null
created_at
string format: date-time
updated_at
string format: date-time
deactivated_identifier
required

The world that stopped being active, if any.

string | null
Examples
ExamplealreadyActive
{
  "map": {
    "identifier": "a28e5bf3-26b4-4a34-9f98-9a116a2700ca",
    "name": "Head office",
    "source_map": null,
    "status": "active",
    "is_active": true,
    "version": 8,
    "activated_at": "2026-08-24T15:27:23-03:00",
    "created_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
    "updated_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
    "created_at": "2026-08-21T11:38:37-03:00",
    "updated_at": "2026-08-24T15:27:23-03:00"
  },
  "deactivated_identifier": null
}

401

Section titled “401”

No authentication key was sent.

Media typeapplication/json

Authentication failures use an error key rather than message.

object
error
required
string
Examples
Examplemissing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

Section titled “403”

The caller is not allowed to do this (see “Who may do what”), or the authentication key is not recognised (empty message).

Media typeapplication/json
object
message
required
string
Examples

Not the space's owner

{
  "message": "You do not have permission to update this space."
}

404

Section titled “404”

Nothing has this identifier.

Media typeapplication/json
object
message
required
string
Examplegenerated
{
  "message": "example"
}

409

Section titled “409”

Another world was activated at the same moment. Retry.

Media typeapplication/json

An error raised by the application’s own rules.

object
error
required
string
status
integer
help
string
Examples
Exampleconflict
{
  "error": "Another map of this workspace was activated at the same time. Please try again.",
  "status": 409
}

419

Section titled “419”

The authentication key is expired or not recognised. Get a fresh one and retry.

Media typeapplication/json

Authentication failures use an error key rather than message.

object
error
required
string
Examples
Exampleexpired
{
  "error": "JWT passport expired: Passport expired"
}