---
title: "Autocomplete Assist"
method: POST
path: "/api/v1/pages/{page_id}/autocomplete-assist"
tags: ["assist"]
---

# Autocomplete Assist

`POST /api/v1/pages/{page_id}/autocomplete-assist`

## Request

- Base URL: `https://api.rudus.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rudus.ai/api/v1/pages/{page_id}/autocomplete-assist`
- Auth: none declared
- TypeScript: <https://skmtc.dev/rudus/apis/rudus-api/docs/api/v1/pages/:page_id/autocomplete-assist/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `page_id` string, uuid, required

## Request body

- AutocompleteAssistRequest
  - `kind` 'rescue' | 'complete', required
  - `image` AssistImage, required: Browser-rendered PNG/JPEG crop, base64 without the data: prefix.
    - `data_base64` string, required
    - `media_type` 'image/png' | 'image/jpeg', required
    - `width_px` integer, required
    - `height_px` integer, required
  - `transform` AssistTransform, required
    - `a` number, required
    - `b` number, required
    - `c` number, required
    - `d` number, required
    - `e` number, required
    - `f` number, required
  - `rescue` RescueContext
    - `stop_point` unknown[], required
      - unknown
    - `heading_deg` number, required
    - `goal_point` unknown[], nullable, required
      - unknown
    - `candidates` RescueCandidate[], required
      - `far_point` unknown[], required
        - unknown
      - `angle_deg` number, required
    - `bridge_point` unknown[], nullable, required
      - unknown
  - `complete` CompleteContext
    - `placed_vertices` array[], required
      - unknown[]
        - unknown
    - `tool` 'polyline' | 'polygon', required

## Response `200`

Successful Response

- AutocompleteAssistResponse: assist is None whenever the VLM was unavailable, timed out, or returned something unusable — a normal state, never an error.
  - `assist` union
    - RescueAssistResult
      - `kind` 'rescue'
      - `choice` union, required
        - integer
        - 'bridge' | 'none'
    - CompleteAssistResult
      - `kind` 'complete'
      - `vertices_pdf` array[], required
        - unknown[]
          - unknown
      - `confidence` 'high' | 'low', required

## Other responses

- `4XX`: Client Error
- `5XX`: Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) - [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rudus/apis/rudus-api/revisions/5673f72c8a5d?raw)