How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cognite Simulator Routines API

The simulator routine resource defines instructions on interacting with a simulator model. A simulator routine includes:- Inputs (values set into the simulator model)- Commands (actions to be performed by the simulator)- Outputs (values read from the simulator model)Simulator routines can have multiple revisions, enabling users to track changes and evolve the routine over time. Each model can have multiple routines, each performing different objectives such as calculating optimal operation setpoints, forecasting production, benchmarking asset performance, and more.#### Limitations:- A project can have a maximum of 10000 simulator routines.- Each simulator model can have a maximum of 10 simulator routines.- Each simulator routine can have a maximum of 10 revisions.- The total size of each routine revision can be a maximum of 50.00 KB.

Cognite Simulator Routines API is one of 90 APIs that Cognite publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Simulator Routines. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 7 operations across 7 paths, and defines 50 schemas. It is described by OpenAPI 3.2.0, at version v1.

Requests are made against a single base URL, https://{cluster}.cognitedata.com/api/v1/projects/{project}.

7 operations 7 paths 50 schemas 7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1
Base URL
https://api.cognitedata.com
Authentication
HTTP Bearer, OAuth 2.0, OAuth 2.0, OAuth 2.0, OpenID Connect
Resource Areas
1

Authentication & Security 5

Cognite Simulator Routines API declares 5 security schemes for authenticating requests. It accepts HTTP bearer tokens (OpenID Connect or OAuth2 token) (oidc-token). It supports OAuth 2.0 (oauth2-client-credentials) using the clientCredentials flow, exposing 1 scope. It supports OAuth 2.0 (oauth2-auth-code) using the authorizationCode flow, exposing 1 scope. It supports OAuth 2.0 (oauth2-open-industrial-data) using the clientCredentials flow, exposing 1 scope. It supports OpenID Connect (org-oidc-token) discovered at https://auth.cognite.com/.well-known/openid-configuration. By default, every request must be authenticated.

  • oidc-token — Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to acce…
  • oauth2-client-credentials — Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to acce…
  • oauth2-auth-code — Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to acce…
  • oauth2-open-industrial-data — Auth flow for Open Industrial Data. Get your client secret from https://hub.cognite.com/open-industrial-data-211.
  • org-oidc-token — Access token issued by the Cognite authorization server, and valid for the target organization. The token must be an OpenID Connect token, and it can be obtain…

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 POST. Each is listed below with its method, path, parameters, and response codes.

Simulator Routines 7

The simulator routine resource defines instructions on interacting with a simulator model. A simulator routine includes: - Inputs (values set into the simulator model) - Commands…

POST
/simulators/routines
Create Simulator Routine
create_simulator_routine_simulators_routines_post body → 201400403500
POST
/simulators/routines/list
Filter Simulator Routines
filter_simulator_routines_simulators_routines_list_post body → 200400403500
POST
/simulators/routines/delete
Delete Simulator Routine
delete_simulator_routine_simulators_routines_delete_post body → 200403500
POST
/simulators/routines/aggregate
Aggregate Simulator Routines
aggregate_simulator_routines body → 200400403500
POST
/simulators/routines/revisions
Create Simulator Routine Revision
create_simulator_routine_revision_simulators_routines_revisions_post body → 201400403413500
POST
/simulators/routines/revisions/list
Filter Simulator Routine Revisions
filter_simulator_routine_revisions_simulators_routines_revisions_list_post body → 200400403500
POST
/simulators/routines/revisions/byids
Retrieve Simulator Routine Revisions
retrieve_simulator_routine_revisions_simulators_routines_revisions_byids_post body → 200400403500

Schemas 50

The contract defines 50 schemas that model the data the API accepts and returns. The most detailed are SimulatorRoutineRevision (12 properties), SimulatorRoutineRevisionView (11 properties), SimulatorRoutineBase (10 properties), ListSimulatorRoutineRevisionsFilters (6 properties). Each schema is shown below with its type and property counts.

APIError
object
2 properties 2 required
SimulatorRoutineOperator
string
InputItems20IdRefOrExternalIdRef
object
1 property 1 required
DataPointsAggregate
string
EmptyResponse
object
SimulatorRoutineOutput
object
5 properties 2 required
ListSimulatorRoutinesQuery
object
4 properties
SimulatorRoutineDataSamplingEnabled
object
4 properties 3 required
SimulationValueType
string
SimulatorRoutineScheduleEnabled
object
2 properties 2 required
ListWithCursorSimulatorRoutineRevisionView
object
2 properties 1 required
SingleItemIdRefOrExternalIdRef
object
1 property 1 required
SimulatorRoutineBase
object
10 properties 8 required
ListSimulatorRoutinesFilters
object
3 properties
ListAggregateCount
object
1 property 1 required
SimulatorRoutineInputConstant
object
6 properties 3 required
SimulatorRoutineStepGet
object
Used to extract the output of a simulation routine and write it back into the Cognite Data Fusion.
4 properties 3 required
SimulatorRoutineInputTimeseries
object
6 properties 3 required
SimulatorRoutineStepCommand
object
Used to run a command in a simulation routine. For example, to run a solver.
4 properties 3 required
SimulatorRoutineConfiguration
object
6 properties 4 required
ListSimulatorRoutineRevision
object
1 property 1 required
SimulatorRoutineStepArgumentsSet
object
1 property 1 required
SingleItemSimulatorRoutineRevisionCreateCommand
object
1 property 1 required
SimulatorRoutineLogicalCheckEnabled
object
5 properties 5 required
SimulatorRoutineRevision
object
12 properties 11 required
SimulatorRoutineCreateCommand
object
5 properties 3 required
AggregateSimulatorRoutinesQuery
object
2 properties 1 required
SimulatorRoutineConfigurationBase
object
4 properties 4 required
IdRef
object
1 property 1 required
SimulatorRoutineStepArgumentsGet
object
1 property 1 required
ListSimulatorRoutineRevisionsFilters
object
6 properties
ListWithCursorSimulatorRoutineRevision
object
2 properties 1 required
SimulationValueUnitInput
object
2 properties 2 required
SingleItemSimulatorRoutineCreateCommand
object
1 property 1 required
ErrorBase
object
1 property 1 required
SimulatorRoutineStage
object
3 properties 2 required
SimulatorRoutineStepArgumentsCommand
object
ListWithCursorSimulatorRoutineBase
object
2 properties 1 required
SimulatorRoutineSteadyStateDetectionEnabled
object
6 properties 5 required
SimulatorRoutineStepSet
object
Used to set the input of a simulation routine from timeseries or constant fields.
4 properties 3 required
SimulatorRoutineRevisionCreateCommand
object
4 properties 4 required
SimulatorRoutineRevisionView
object
11 properties 10 required
ExternalIdRef
object
1 property 1 required
SortByCreatedTime
object
2 properties 2 required
ListSimulatorRoutineRevisionsQuery
object
5 properties
EpochTimestampRange
object
Range between two timestamps (inclusive).
2 properties
ListSimulatorRoutineBase
object
1 property 1 required
SimulatorRoutineConfigDisabled
object
1 property 1 required
AggregateCount
object
1 property 1 required
SimulatorRoutineConfigurationCreate
object
6 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cognite-simulator-routines-api-openapi.yml Raw ↑

Other APIs Cognite publishes across the network.

Cognite Data Fusion API
Cognite 3D Asset Mapping API
Cognite 3D Files API
Cognite 3D Jobs API
Cognite 3D Model Revisions API
Cognite 3D Models API
Cognite Annotations API
Cognite Assets API
Cognite Connections API
Cognite Containers API
Cognite Data models API
Cognite Data point subscriptions API
Where this information came from

This is an independent, third-party profile of Cognite Simulator Routines API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.