GET STARTED

Quickstart

Make your first Rowe API request in a few minutes. Create an API key, send a point cloud or cad_scene to the Responses API, and inspect the typed output, reasoning_scene, and usage metadata.

Create a key

Generate an API key from the dashboard and store it server-side.

Send input

Call the Responses API with model and spatial input.

Use output

Read typed outputs, usage, and request_id from the response.

Create your first response

Store your API key server-side, then call the Responses API with a model and spatial input.

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": "fit",
      "object_id": "case",
      "secondary_id": "shelf",
      "point_cloud_scene": {
        "point_clouds": [
          {
            "object_id": "case",
            "kind": "box",
            "points": [
              { "x": 0, "y": 0, "z": 0 },
              { "x": 1, "y": 0, "z": 0 },
              { "x": 0, "y": 1, "z": 1 }
            ]
          }
        ]
      }
    }
  }'

For native CAD and engineering workflows, send a structured cad_scene instead of sampling geometry to points.

Terminal

$ 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": "optimize",
$       "object_id": "bracket",
$       "cad_scene": {
$         "scene_id": "bracket-review",
$         "schema_version": "four-cad.cad_scene.v1",
$         "source_format": "step",
$         "units": "millimeter",
$         "structure": {
$           "kind": "brep",
$           "solids": [
$             {
$               "id": "solid-1",
$               "volume": 1250,
$               "bounding_box": {
$                 "x_min": 0,
$                 "x_max": 120,
$                 "y_min": 0,
$                 "y_max": 55,
$                 "z_min": 0,
$                 "z_max": 25
$               },
$               "faces": [{ "face_type": "plane" }]
$             }
$           ],
$           "features": [
$             { "id": "base_extrude", "feature_type": "extrude", "parameters": { "depth": 25 } }
$           ],
$           "dimensions": [
$             { "dim_type": "linear", "measurement": 120, "text": "120 mm" }
$           ]
$         }
$       }
$     }
$   }'