---
title: "Get Ky Folders"
method: GET
path: "/api/ky-folder/"
tags: ["KY Training"]
---

# Get Ky Folders

`GET /api/ky-folder/`

## Request

- Base URL: `https://api.avete.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avete.ai/api/ky-folder/`
- Auth: HTTP bearer

## Query parameters

- `site_id` integer, nullable

## Response `200`

Successful Response

- KYFolderResponse[]
  - `id` string, uuid, required
  - `folder_name` string, required
  - `foreman` CompanyMemberRead
    - `id` integer, required
    - `company_id` integer, required
    - `aws_id` string, nullable
    - `name` string, required
    - `email` string, required
    - `status` string, required
    - `role` string, required
    - `site_id` integer, nullable
    - `site_name` string, nullable
    - `position_id` integer, nullable
    - `position_name` object, nullable, required
    - `last_login` string, date-time, required
    - `joined` string, date-time, required
    - `invited_by_email` string, nullable
    - `longform_video_notification_interval` string, nullable
    - `default_folder_id` integer, nullable
  - `conversations` KYTrainingConversationResponse[]
    - `id` string, uuid, required
    - `title` string, required
    - `created_at` string, date-time, required
    - `summary` object, nullable
    - `is_completed` boolean, required
    - `time_taken` string, nullable
    - `status` string, required
    - `site_id` integer, nullable
    - `ky_training_time_id` integer, nullable
    - `approved_by` integer, nullable
    - `ky_folder_id` string, uuid, nullable
    - `audit_trail` object[], nullable
    - `messages` KYTrainingMessageResponse[]
      - `id` string, uuid, required
      - `conversation_id` string, uuid, required
      - `content` string, required
      - `is_user` boolean, required
      - `timestamp` string, date-time, required
      - `language` string, required
    - `conduct` KYConductResponse
      - `id` string, uuid, required
      - `conduct_date` string, date-time, required
      - `analysis` object, nullable
      - `attendee_members` WorkerResponse[]
        - `id` integer, required
        - `name` string, required
        - `email` string, required
        - `role` string, required
    - `expected_attendees` WorkerResponse[]
      - `id` integer, required
      - `name` string, required
      - `email` string, required
      - `role` string, required
    - `approver` WorkerResponse
      - `id` integer, required
      - `name` string, required
      - `email` string, required
      - `role` string, required
    - `ky_training_time` KYTrainingTimeRead
      - `start_time` string, date-time, required
      - `skip` boolean, nullable: Whether to skip this training time
      - `id` integer, required
      - `company_member_id` integer, required
      - `day_of_week` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/avete/apis/fastcognito.md) - [All operations](https://skmtc.dev/avete/apis/fastcognito/llms.txt) - [OpenAPI document](https://skmtc.dev/avete/apis/fastcognito/revisions/2c3bbf575ddb?raw)