# Placement

> Use task_type placement with geometry and a goal to produce placement recommendations.

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

## task

placement

## question

Where can this go, given the space and the goal?

## required

| Field | Type | Description |
| --- | --- | --- |
| input.object_id | string | The object to place. |
| input.goal | object | Target state, region, or objective to satisfy. |
| input.cad_scene | object | The scene it is being placed into. |

## returns

| Field | Type | Description |
| --- | --- | --- |
| placement_result.candidates | Ranked positions and orientations. |
| placement_result.clearances | Per-candidate measured clearance. |
| placement_result.rejected | Positions ruled out, with the reason. |

## notes

Supply a goal. Without one the task has no objective to rank candidates against and will return the geometrically valid set in arbitrary order.

## 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": "placement",
      "object_id": "sensor",
      "goal": { "objective": "maximize_clearance" },
      "cad_scene": { "schema": "four-cad.cad_scene.v1", "solids": [] }
    }
  }'
```