# ForceState Instance

Endpoint for forcing a specific instance to a specific state.

Endpoint: POST /api/instances/{instanceID}/force-state
Version: 1.0
Security: x-api-key

## Query parameters:

  - `orgIdentifier` (string)
    Org is the organization identifier.

  - `projectIdentifier` (string)
    Project is the project identifier.

## Path parameters:

  - `instanceID` (string, required)
    ID of the instance to force status for

## Header parameters:

  - `Harness-Account` (string, required)
    Account is the internal customer account ID.

## Request fields (application/json):

  - `infrastructureID` (string, required)
    ID of the infrastructure

  - `state` (object)

  - `state.state` (string, required)
    Enum: "unknown", "inactive", "instantiated", "running", "paused"

## Response 400 fields (application/json):

  - `code` (string)

  - `details` (object)

  - `message` (string, required)

  - `name` (string, required)


## Response 200 fields