Skip to content

Scenarios

List scenarios

GET /sympheny-app/analysis/{guid}/scenario

Requires a Bearer token. SDK method: client.scenarios.list().

Parameters

Name In Type Required Description
guid path string yes

Example request

curl -X GET "https://eu-north-1-api.sympheny.com/sympheny-app/analysis/{guid}/scenario" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN"

Responses

Status Description Schema
200 OK ResponseDtoListFScenarioResponseDto

Example response (200)

{
  "data": [
    {
      "scenarioGuid": "string",
      "scenarioName": "string",
      "updated": "2026-01-01T00:00:00Z",
      "readyForExecution": true,
      "preparingExecutionV2": true,
      "masterScenarioGuid": "string",
      "projectGuid": "string",
      "projectName": "string",
      "analysisGuid": "string",
      "analysisName": "string",
      "enymap": {
        "length": 0,
        "interestRate": 0.0,
        "exchangeCurrency": "string",
        "exchangeRate": 0.0,
        "scope": "BUILDING_DEVELOPMENTS",
        "technologies": [
          "PV"
        ],
        "demands": [
          "HOT_WATER"
        ],
        "imports": [
          "ELECTRICITY"
        ],
        "exports": [
          "HEAT_AMBIENT"
        ],
        "multiHubs": true
      },
      "variant": true
    }
  ],
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}

Create new scenario

POST /sympheny-app/analysis/{guid}/scenario

Requires a Bearer token. SDK method: client.scenarios.create().

Parameters

Name In Type Required Description
guid path string yes

Request body (ScenarioRequestDto)

Field Type Required Description
scenarioName string yes

Example request

curl -X POST "https://eu-north-1-api.sympheny.com/sympheny-app/analysis/{guid}/scenario" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "scenarioName": "string"
}'

Responses

Status Description Schema
201 Created ResponseDtoScenarioResponseDto

Example response (201)

{
  "data": {
    "scenarioGuid": "string",
    "scenarioName": "string",
    "updated": "2026-01-01T00:00:00Z",
    "readyForExecution": true,
    "preparingExecutionV2": true,
    "masterScenarioGuid": "string",
    "projectGuid": "string",
    "projectName": "string",
    "analysisGuid": "string",
    "analysisName": "string",
    "enymap": {
      "length": 0,
      "interestRate": 0.0,
      "exchangeCurrency": "string",
      "exchangeRate": 0.0,
      "scope": "BUILDING_DEVELOPMENTS",
      "technologies": [
        "PV"
      ],
      "demands": [
        "HOT_WATER"
      ],
      "imports": [
        "ELECTRICITY"
      ],
      "exports": [
        "HEAT_AMBIENT"
      ],
      "multiHubs": true
    },
    "variant": true
  },
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}

Get scenario

GET /sympheny-app/scenario/{scenarioGuid}

Requires a Bearer token. SDK method: client.scenarios.get().

Parameters

Name In Type Required Description
scenarioGuid path string yes

Example request

curl -X GET "https://eu-north-1-api.sympheny.com/sympheny-app/scenario/{scenarioGuid}" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN"

Responses

Status Description Schema
200 OK ResponseDtoScenarioResponseDto

Example response (200)

{
  "data": {
    "scenarioGuid": "string",
    "scenarioName": "string",
    "updated": "2026-01-01T00:00:00Z",
    "readyForExecution": true,
    "preparingExecutionV2": true,
    "masterScenarioGuid": "string",
    "projectGuid": "string",
    "projectName": "string",
    "analysisGuid": "string",
    "analysisName": "string",
    "enymap": {
      "length": 0,
      "interestRate": 0.0,
      "exchangeCurrency": "string",
      "exchangeRate": 0.0,
      "scope": "BUILDING_DEVELOPMENTS",
      "technologies": [
        "PV"
      ],
      "demands": [
        "HOT_WATER"
      ],
      "imports": [
        "ELECTRICITY"
      ],
      "exports": [
        "HEAT_AMBIENT"
      ],
      "multiHubs": true
    },
    "variant": true
  },
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}

Delete scenario

DELETE /sympheny-app/scenario/{scenarioGuid}

Requires a Bearer token. SDK method: client.scenarios.delete().

Parameters

Name In Type Required Description
scenarioGuid path string yes

Example request

curl -X DELETE "https://eu-north-1-api.sympheny.com/sympheny-app/scenario/{scenarioGuid}" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN"

Responses

Status Description Schema
200 OK ResponseDtoStatus

Example response (200)

{
  "data": {
    "code": "string",
    "desc": "string",
    "message": "string"
  },
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}

Copy scenario

PUT /sympheny-app/scenarios/copy/{scenarioGuid}

Requires a Bearer token. SDK method: client.scenarios.copy().

Parameters

Name In Type Required Description
scenarioGuid path string yes
analysisDestinationGuid query string no
name query string no

Example request

curl -X PUT "https://eu-north-1-api.sympheny.com/sympheny-app/scenarios/copy/{scenarioGuid}" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN"

Responses

Status Description Schema
200 OK ResponseDtoScenarioResponseDto

Example response (200)

{
  "data": {
    "scenarioGuid": "string",
    "scenarioName": "string",
    "updated": "2026-01-01T00:00:00Z",
    "readyForExecution": true,
    "preparingExecutionV2": true,
    "masterScenarioGuid": "string",
    "projectGuid": "string",
    "projectName": "string",
    "analysisGuid": "string",
    "analysisName": "string",
    "enymap": {
      "length": 0,
      "interestRate": 0.0,
      "exchangeCurrency": "string",
      "exchangeRate": 0.0,
      "scope": "BUILDING_DEVELOPMENTS",
      "technologies": [
        "PV"
      ],
      "demands": [
        "HOT_WATER"
      ],
      "imports": [
        "ELECTRICITY"
      ],
      "exports": [
        "HEAT_AMBIENT"
      ],
      "multiHubs": true
    },
    "variant": true
  },
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}

Rename scenario

PUT /sympheny-app/scenarios/{scenarioGuid}

Requires a Bearer token. SDK method: client.scenarios.rename().

Parameters

Name In Type Required Description
scenarioGuid path string yes

Request body (ScenarioRequestDto)

Field Type Required Description
scenarioName string yes

Example request

curl -X PUT "https://eu-north-1-api.sympheny.com/sympheny-app/scenarios/{scenarioGuid}" \
  -H "Authorization: Bearer $SYMPHENY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "scenarioName": "string"
}'

Responses

Status Description Schema
200 OK ResponseDtoScenarioResponseDto

Example response (200)

{
  "data": {
    "scenarioGuid": "string",
    "scenarioName": "string",
    "updated": "2026-01-01T00:00:00Z",
    "readyForExecution": true,
    "preparingExecutionV2": true,
    "masterScenarioGuid": "string",
    "projectGuid": "string",
    "projectName": "string",
    "analysisGuid": "string",
    "analysisName": "string",
    "enymap": {
      "length": 0,
      "interestRate": 0.0,
      "exchangeCurrency": "string",
      "exchangeRate": 0.0,
      "scope": "BUILDING_DEVELOPMENTS",
      "technologies": [
        "PV"
      ],
      "demands": [
        "HOT_WATER"
      ],
      "imports": [
        "ELECTRICITY"
      ],
      "exports": [
        "HEAT_AMBIENT"
      ],
      "multiHubs": true
    },
    "variant": true
  },
  "status": {
    "code": "string",
    "desc": "string",
    "message": "string"
  }
}