> ## Documentation Index > Fetch the complete documentation index at: https://developers.conveyour.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a folder > Returns a single lesson folder. Get a lesson folder ## OpenAPI ````yaml /api-reference/specs/lessons.json get /api/lessons/folders/{id} openapi: 3.1.0 info: title: ConveYour API — Lessons description: Retrieve, search, and manage lessons and lesson folders. version: 1.0.0 servers: - url: https://{subdomain}.conveyour.com description: Your organization's ConveYour instance variables: subdomain: default: acme description: >- Your organization's slug — the subdomain you sign in on. Replace `acme` with yours: if you sign in at `bigco.conveyour.com`, enter `bigco`. security: - conveyourToken: [] tags: - name: Lessons description: Retrieve, search, and manage lessons and lesson folders. paths: /api/lessons/folders/{id}: get: tags: - Lessons summary: Get a folder description: |- Returns a single lesson folder. Get a lesson folder operationId: getALessonFolder parameters: - name: id in: path required: true description: The id identifier. schema: type: string - $ref: '#/components/parameters/teams' - name: schema in: query description: Which field set to return. Defaults to `full`. required: false schema: type: string default: full - name: deleted in: query description: Return soft-deleted folders instead of active ones. required: false schema: type: boolean default: false - name: folder_id in: query description: >- Only folders whose parent is this ID. Pass `null` to get top-level folders. required: false schema: type: string - name: page in: query description: >- Page number for the CHILD listing. Passing this switches each child array to a paginated object. required: false schema: type: integer - name: per_page in: query description: >- Children per page when page is passed. Defaults to 50, capped at limits.folder_children. required: false schema: type: integer default: 50 responses: '200': description: Success. content: application/json: schema: allOf: - $ref: '#/components/schemas/Envelope' - type: object properties: data: $ref: '#/components/schemas/LessonFolder' example: status: ok message: success data: id: 64a1b2c3d4e5f6a7b8c9d0e1 name: Compliance Training folder_id: null '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' components: parameters: teams: name: teams[] in: query description: >- Team scope for the request, as one or more team ObjectIds. The brackets are required: PHP keeps only the last value for a repeated plain key, so `teams=A&teams=B` silently resolves to B alone. On requests with a JSON body you may send `teams` (no brackets) in the body instead. **Values that are not valid ObjectIds are silently ignored** — a mistyped team ID behaves as if no team was sent. See the [teams section of the API conventions guide](/guides/api-conventions#team-scoping). style: form explode: true schema: type: array items: type: string example: - 64a1b2c3d4e5f6a7b8c9d0ff schemas: Envelope: type: object description: The common response envelope shared by all ConveYour endpoints. properties: status: type: string enum: - ok - failed description: '`ok` on success, `failed` on error.' message: type: string description: Human-readable description of the result. data: description: >- The response payload — an object or an array depending on the endpoint. LessonFolder: type: object description: >- A lesson folder. Child listings and flags are added by the read endpoints. properties: id: type: string description: Folder ID. name: type: string description: Folder name. folder_id: type: - string - 'null' description: Parent folder ID; null at the top level. org_id: type: integer description: Owning organization. user_id: type: integer description: User who created the folder. teams: type: array items: type: string description: >- Team scope. Removed when the org does not have the teams feature enabled. lessons: oneOf: - type: array items: $ref: '#/components/schemas/Lesson' description: >- All child lessons, capped at limits.folder_children (default 1000). - type: object description: Returned instead when page is passed. properties: page: type: integer pages: type: integer count: type: integer results: type: array items: $ref: '#/components/schemas/Lesson' description: Child lessons. lessons_count: type: integer description: Number of child lessons. folders: type: array items: type: object description: Child folders. folders_count: type: integer description: Number of child folders. editable: type: boolean description: Always `true`. deletable: type: boolean description: Always `true`. created_at: type: string description: Creation timestamp. updated_at: type: string description: Last update timestamp. Lesson: type: object description: A lesson. properties: id: type: string description: Lesson ID. uuid: type: string description: Stable identifier. Required on create. name: type: string description: Lesson name. title: type: string description: Display title. org_id: type: integer description: Owning organization. user_id: type: integer description: Author. banner_img: type: string description: Banner image. icon: type: string description: Icon. items: type: array description: >- Lesson items. Each item's shape depends on its type — see the lesson item templates. items_count: type: integer description: Number of items. length: type: integer description: Estimated length. folder_id: type: string description: Containing folder. order: type: number description: Sort order. order_updated_at: type: integer description: When the order last changed. teams: type: array description: Teams the lesson is scoped to. deleted_at: type: integer description: Soft-delete timestamp. created_at: type: integer description: Unix timestamp. updated_at: type: integer description: Unix timestamp. required: - uuid responses: Forbidden: description: >- The token is missing or invalid, or the service account behind it lacks the permission this endpoint requires. content: application/json: example: status: failed message: Lacking necessary permission add_contacts data: permission: add_contacts NotFound: description: No record matched the supplied ID. content: application/json: example: status: failed message: Contact not found data: [] securitySchemes: conveyourToken: type: apiKey in: header name: x-conveyour-token description: >- Your API key token. Contacts endpoints require a **Server-only — Full API** key — see [Authentication](/quickstart). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.