---
title: "Detect canvas natural facing"
method: POST
path: "/v1/collections/{id}/canvases/{canvasId}/presentation/detect-facing"
tags: ["Canvases"]
deprecated: true
---

# Detect canvas natural facing

`POST /v1/collections/{id}/canvases/{canvasId}/presentation/detect-facing`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/collections/{id}/canvases/{canvasId}/presentation/detect-facing`
- Auth: HTTP bearer

> **Deprecated.**

Analyzes completed canvas node images and returns a suggested presentation.naturalFacing value plus node-level evidence. This is a synchronous analysis endpoint. It does not write to the canvas graph and has no credit cost.

## Path parameters

- `id` string, uuid, required
- `canvasId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Response `200`

Suggested natural-facing presentation value

- CanvasFacingDetectionResponse
  - `data` CanvasFacingDetectionData, required
    - `suggestedNaturalFacing` 'left' | 'neutral' | 'right', required
    - `confidence` number, required
    - `warning` string
    - `analyzedNodeCount` integer, required
    - `nodeResults` object[], required
      - `nodeId` string, required
      - `nodeName` string, required
      - `facing` 'left' | 'neutral' | 'right', required
      - `confidence` number, required
      - `reason` string

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/84832e255613?raw)