---
title: "Train Pta"
method: POST
path: "/api/v1/workspaces/{workspace_id}/pta/train"
---

# Train Pta

`POST /api/v1/workspaces/{workspace_id}/pta/train`

## Path parameters

- `workspace_id` string, uuid4, required

## Headers

- `x-real-ip` string, nullable
- `askui-user-agent` string, nullable
- `askui-installed-at` string, nullable
- `askui-user-id` string, nullable

## Request body

- PtaTrainRequestBody
  - `annotations` Annotation[], required
    - `description` string, required
    - `category` 'text' | 'textfield' | 'button' | 'icon' | 'checkbox' | 'other', required
    - `rectangle` BoundingBox, required
      - `xmin` number, required
      - `ymin` number, required
      - `xmax` number, required
      - `ymax` number, required
  - `image` string, required
  - `model` 'alpha'

## Response `200`

Successful Response

- unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/askui/apis/askui-inference-api.md) · [All operations](https://skmtc.dev/askui/apis/askui-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/askui/askui-inference-api/revisions/0f3efe985ebb/schema)