Scenarios API

coming soon - create digital twins to test "What if?" scenarios

get

Retrieve scenarios. The scenario_id can be used as x-configuiration-key on other public APIs.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

scenario_idstringOptional

modestringOptional

skipintegerOptionalDefault: 0

limitintegerOptionalDefault: 25

sortstringOptional

orderstring · enumOptionalDefault: ascPossible values:

Responses

200

OK

application/json

get

/scenarios

HTTPcURLJavaScriptPython

GET /scenarios/v1/scenarios HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "scenarios": [
      {
        "_id": "text",
        "scenario_id": "text",
        "name": "text",
        "description": "text",
        "status": "text",
        "mode": "text",
        "settings": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "notes": [
          {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "changes": true,
        "unsaved_changes": true,
        "created_by": "text",
        "created_at": "2026-02-05T12:33:39.282Z",
        "updated_by": "text",
        "updated_at": "2026-02-05T12:33:39.282Z",
        "archived_by": "text",
        "archived_at": "2026-02-05T12:33:39.282Z",
        "deleted_by": "text",
        "deleted_at": "2026-02-05T12:33:39.282Z",
        "active_admins": [
          {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        ],
        "services_publishing": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "identifier": "text"
}

post

Create a new scenario.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

namestringRequired

descriptionstringOptional

modestringRequired

Responses

200

OK

application/json

post

/scenarios

HTTPcURLJavaScriptPython

POST /scenarios/v1/scenarios HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "name": "text",
  "description": "text",
  "mode": "text",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "notes": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

get

Retrieve a scenario by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

scenario_idstringRequired

Responses

200

OK

application/json

get

/scenarios/{scenario_id}

HTTPcURLJavaScriptPython

GET /scenarios/v1/scenarios/{scenario_id} HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

put

Update a scenario.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

scenario_idstringRequired

Body

application/json

namestringOptional

descriptionstringOptional

modestringOptional

Responses

200

OK

application/json

put

/scenarios/{scenario_id}

HTTPcURLJavaScriptPython

PUT /scenarios/v1/scenarios/{scenario_id} HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "name": "text",
  "description": "text",
  "mode": "text",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "notes": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

delete

Delete a scenario.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

scenario_idstringRequired

Responses

200

OK

application/json

delete

/scenarios/{scenario_id}

HTTPcURLJavaScriptPython

DELETE /scenarios/v1/scenarios/{scenario_id} HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

post

Publish a scenario's changes.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

scenario_idstringRequired

Body

application/json

namestringOptional

descriptionstringOptional

modestringOptional

Responses

200

OK

application/json

post

/scenarios/{scenario_id}/publish

HTTPcURLJavaScriptPython

POST /scenarios/v1/scenarios/{scenario_id}/publish HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 149

{
  "name": "text",
  "description": "text",
  "mode": "text",
  "settings": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "notes": [
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

delete

Discard unsaved changes for a scenario.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

scenario_idstringRequired

Responses

200

OK

application/json

delete

/scenarios/{scenario_id}/discard

HTTPcURLJavaScriptPython

DELETE /scenarios/v1/scenarios/{scenario_id}/discard HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "_id": "text",
    "scenario_id": "text",
    "name": "text",
    "description": "text",
    "status": "text",
    "mode": "text",
    "settings": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "notes": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "changes": true,
    "unsaved_changes": true,
    "created_by": "text",
    "created_at": "2026-02-05T12:33:39.282Z",
    "updated_by": "text",
    "updated_at": "2026-02-05T12:33:39.282Z",
    "archived_by": "text",
    "archived_at": "2026-02-05T12:33:39.282Z",
    "deleted_by": "text",
    "deleted_at": "2026-02-05T12:33:39.282Z",
    "active_admins": [
      {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "services_publishing": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

get

Retrieve changes. Use scenario_id to filter changes for a single scenario.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Query parameters

scenario_idstringOptional

configuration_idstringOptional

servicestringOptional

entity_idstringOptional

entity_typestringOptional

methodstringOptional

statusstringOptional

skipintegerOptionalDefault: 0

limitintegerOptionalDefault: 25

Responses

200

OK

application/json

get

/changes

HTTPcURLJavaScriptPython

GET /scenarios/v1/changes HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "changes": [
      {
        "_id": "text",
        "change_id": "text",
        "configuration_id": "text",
        "status": "text",
        "service": "text",
        "entity_id": "text",
        "entity_type": "text",
        "method": "text",
        "data": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "created_by": "text",
        "created_at": "2026-02-05T12:33:39.282Z",
        "updated_by": "text",
        "updated_at": "2026-02-05T12:33:39.282Z",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    ],
    "pagination": {
      "current_results": {
        "from": 1,
        "to": 1
      },
      "total_results": 1,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  },
  "identifier": "text"
}

post

Create one or more changes.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

session_idstringOptional

Responses

200

OK

application/json

post

/changes

HTTPcURLJavaScriptPython

POST /scenarios/v1/changes HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 216

{
  "session_id": "text",
  "changes": [
    {
      "configuration_id": "text",
      "service": "text",
      "entity_id": "text",
      "entity_type": "text",
      "method": "text",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "created_by": "text",
      "status": "text"
    }
  ]
}

200

OK

{
  "success": true,
  "data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

put

Update one or more changes.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Body

application/json

merge_to_savedbooleanOptional

session_idstringOptional

Responses

200

OK

application/json

put

/changes

HTTPcURLJavaScriptPython

PUT /scenarios/v1/changes HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "merge_to_saved": true,
  "session_id": "text",
  "changes": [
    {
      "change_id": "text",
      "service": "text",
      "entity_id": "text",
      "entity_type": "text",
      "status": "text",
      "method": "text",
      "data": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      }
    }
  ]
}

200

OK

{
  "success": true,
  "data": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "identifier": "text"
}

delete

Delete a change by ID.

Authorizations

ApiKeyAuth

x-api-keystringRequired

Path parameters

change_idstringRequired

Responses

200

OK

application/json

delete

/changes/{change_id}

HTTPcURLJavaScriptPython

DELETE /scenarios/v1/changes/{change_id} HTTP/1.1
Host: api.gospace.app
x-api-key: YOUR_API_KEY
Accept: */*

200

OK

{
  "success": true,
  "data": {
    "_id": "text"
  },
  "identifier": "text"
}