Get the current state of the instance

1min

GET
This API is to get the current state of the instance.
Header/Path/QueryDescriptionTypeValidation
X-COREOS-REQUEST-ID*(header)Unique request ID.string
entityType*(path)Name of an entity type.string
instanceId*(path)Unique id of an instance of the entity type.string
type(query)Type of state data to be returned.stringAvailable values: current, allDefault value: current
*This is required.
HTTP Status Code Summary
CodeDescription
200 - OKEverything worked as expected.
| **400 - Bad Request** | The request was unacceptable, often due to missing a required parameter. |
| **401 - Unauthorized** | No valid API key provided. |
| **404 - Not Found** | The requested resource doesn't exist. |
| **503 - Server Errors** | Something went wrong on our end. (These are rare.) |
PATH PARAMETERS
entityCode
EntityCode
*
Code of an entity.
instanceId
UniqueId
*
Unique id of an instance of the entity type.
HEADER PARAMETERS
X-COREOS-REQUEST-ID
string
*
Unique requestId
X-COREOS-TID
string
*
Tenant id
X-COREOS-ACCESS
string
*
core-os access token
X-COREOS-USERINFO
string
core-os user info token
QUERY PARAMETERS
type
string
Type of state data to be returned
RESPONSES
200
Instance State
InstanceStateGetResponse
error
Error
Error Information
data
InstanceState
request
Request
400
Bad request - The server is unable to process the request due to something that is perceived to be a client error.
ErrorResponse
error
Error
*
Error Information
request
Request
*
401
Unauthorized -  The client's identity is unknown to the server. Verify that you are accessing the correct tenant and that your client ID and client secret are valid on that Tenant.
ErrorResponse
error
Error
*
Error Information
request
Request
*
404
Not found - The server can not find the requested resource.
ErrorResponse
error
Error
*
Error Information
request
Request
*
503
Server error - The server is not ready to handle the request. This could be due to maintenance downtime or system resource constraints.
ErrorResponse
error
Error
*
Error Information
request
Request
*
﻿
﻿

Header/Path/Query	Description	Type	Validation
`X-COREOS-REQUEST-ID`*(header)	Unique request ID.	string
`entityType`*(path)	Name of an entity type.	string
`instanceId`*(path)	Unique id of an instance of the entity type.	string
`type`(query)	Type of state data to be returned.	string	Available values: current, allDefault value: current
*This is required.

Code	Description
200 - OK	Everything worked as expected.

Updated 21 Sep 2023

Did this page help you?

Populate the instance with the default state

Apply event on an instance.