> ## Documentation Index > Fetch the complete documentation index at: https://avala.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get slices itemslist > Slice items (e.g. images from associated datasets) ## OpenAPI ````yaml /openapi.yml get /slices/{owner_name}/{slice_slug}/items/list/ openapi: 3.0.0 info: title: Avala API description: > # Authentication ## Generating an API Key The Avala SDK uses API keys to authenticate requests. You can create and manage your API keys from the Settings page of Mission Control. Follow these steps to generate a new API key: 1. Open your settings page by clicking on your user avatar located at the top right-hand corner of any Mission Control screen, and select `Settings`. 2. From the left-hand sub-menu, select `Security & Identity`. 3. Click on `New API Key`, enter a name for the key, and then click `Create key`. The new key will be automatically copied to your clipboard. Please note, for security reasons, the key will not be accessible once you close the window. Ensure you store it in a safe location before closing the pop-up modal. ### Video walkthrough of API key generation ## Authenticating with an API Key This is the easiest part! Just add a header named `X-Avala-Api-Key` to your requests and set the previously generated API Key as the value. termsOfService: https://avala.ai/legal/terms contact: email: support@avala.ai version: v1 servers: - url: https://api.avala.ai/api/v1 security: - API_Key: [] - JWT: [] tags: - name: datasets description: To be completed... - name: projects description: To be completed... - name: tasks description: List and retrieve annotation tasks. - name: exports description: To be completed... paths: /slices/{owner_name}/{slice_slug}/items/list/: parameters: - name: owner_name in: path required: true schema: type: string - name: slice_slug in: path required: true schema: type: string get: tags: - slices description: Slice items (e.g. images from associated datasets) operationId: slices_items_list_list parameters: - name: ordering in: query description: Which field to use when ordering the results. required: false schema: type: string - name: cursor in: query description: The pagination cursor value. required: false schema: type: string - name: limit in: query description: Number of results to return per page. required: false schema: type: integer - name: order in: query description: >- Sets the CursorPagination `offset` when `cursor` is also set. e.g. `cursor=...&offset=1` schema: type: string - name: reverse in: query description: >- Sets the CursorPagination `reverse` when `cursor` is also set. e.g. `cursor=...&reverse=1`. schema: type: integer responses: '200': description: '' content: application/json: schema: required: - results type: object properties: next: type: string format: uri nullable: true previous: type: string format: uri nullable: true results: type: array items: $ref: '#/components/schemas/DatasetListItem' components: schemas: DatasetListItem: required: - key type: object properties: id: title: Id type: integer readOnly: true uid: title: Uid type: string format: uuid readOnly: true key: title: Key type: string maxLength: 1024 minLength: 1 dataset: title: Dataset type: string readOnly: true url: title: Url type: string readOnly: true minLength: 1 gpu_texture_url: title: Gpu texture url type: string readOnly: true thumbnails: type: array items: type: string nullable: true readOnly: true video_thumbnail: title: Video thumbnail description: Get the URL for the video thumbnail (.webm clip) if available. type: string readOnly: true minLength: 1 metadata: title: Metadata type: object export_snippet: title: Export snippet type: object readOnly: true nullable: true created_at: title: Created at type: string format: date-time readOnly: true updated_at: title: Updated at type: string format: date-time readOnly: true crop_data: $ref: '#/components/schemas/DatasetItemCrop' related_items: type: array items: $ref: '#/components/schemas/RelatedItem' readOnly: true related_sequence_uid: title: Related sequence uid type: string format: uuid readOnly: true DatasetItemCrop: type: object properties: crop_annotations_in_2d: type: array items: $ref: '#/components/schemas/CropAnnotationsIn2dSerailizer' nullable: true crop_annotations_polygon_mask: description: >- List of coordinates for the polygon mask in the format: [[x1, y1], ..., [xN, yN]]. type: array items: type: array items: type: number maxItems: 2 minItems: 2 readOnly: true minItems: 3 nullable: true where: title: Where type: string enum: - dataset - sequence - frame - dataset_item nullable: true RelatedItem: required: - sensor_id - sensor_index - uid type: object properties: sensor_id: title: Sensor id type: string minLength: 1 nullable: true sensor_index: title: Sensor index type: integer nullable: true uid: title: Uid type: string format: uuid nullable: true CropAnnotationsIn2dSerailizer: required: - z - classes type: object properties: z: title: Z type: number classes: type: array items: type: string minLength: 1 minItems: 1 nullable: true securitySchemes: API_Key: type: apiKey name: X-Avala-Api-Key in: header description: >- API key for authentication. Generate one in Mission Control Settings > Security & Identity. JWT: type: apiKey name: Authorization in: header description: JWT token with 'JWT' prefix, e.g., 'JWT eyJhbGciOiJIUzI1NiIsInR...' ````