# Stability analysis

> Use task_type stability to estimate whether a placement or object state is physically stable.

Source: https://fourechelon.com/docs/stability-analysis · Machine-readable: https://fourechelon.com/openapi.json · Index: https://fourechelon.com/llms.txt

## task

stability

## question

If it is placed like this, does it stay put?

## required

| Field | Type | Description |
| --- | --- | --- |
| input.object_id | string | The object whose stability is in question. |
| input.cad_scene | object | Geometry including the supporting surfaces. point_cloud_scene also works. |

## returns

| Field | Type | Description |
| --- | --- | --- |
| stability_result.stable | Whether the placement holds. |
| stability_result.support | Contact area and supporting entities. |
| stability_result.risks | Constraints that would make it fail. |

## notes

This is a geometric stability estimate over the supplied scene. It is not a rigid-body simulation and carries no dynamic, friction, or material model.

## Example

```bash
curl https://fourechelon.com/api/v1/responses \
  -H "Authorization: Bearer $FOUR_ECHELON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rowe-1.0",
    "input": {
      "task_type": "stability",
      "object_id": "fixture",
      "cad_scene": { "schema": "four-cad.cad_scene.v1", "solids": [] }
    }
  }'
```