> Agent-readable docs index: /llms.txt. Fetch only the needed Markdown pages first; use /docs.zip only for broad search after checking /docs-manifest.json or /docs.zip.sha256. # Image This is the API for images. It provides features for generating upload URLs and registering Client images.

Key Concepts

presigned URL: Definition: A temporary upload URL issued to allow image files to be uploaded.
Description: Instead of sending files directly to the KOS API, upload the image binary to the URL in the response via a PUT request. The issued URL is valid for 5 minutes.
Client Image: Definition: Image file information linked to and managed for a Client.
Description: After uploading a file, register it as a Client image by providing the file name, Client ID, image source, capture date and time, and other details.
Image Source: Definition: A value that identifies where the image was generated.
Description: Indicates the context in which the image was created, such as in-clinic capture, Client capture, consent form, or pen chart.
Capture Device Code: Definition: A code representing the device used to capture the image.
Description: Used to identify the capture device of an image by linking it to the device code managed by the clinic.
Image Classification Code: Definition: A code used to classify images based on operational criteria.
Description: Used to organize images according to the image classification system defined by the clinic, such as progress photos or consultation materials.
Image Folder Path: Definition: The path indicating the folder location to which an image belongs.
Description: Subfolders are separated by a slash (/), allowing Client images to be managed in a folder structure.

## Endpoints - [Issue image upload URL](/en/docs/openapi/generate-uploading-image-url.md): `POST /image/open/v1/commands/generate-uploading-url` - [Register Client images](/en/docs/openapi/register-visitor-images.md): `POST /image/open/v1/commands/register-visitor-images`