> ## Documentation Index > Fetch the complete documentation index at: https://docs.cuadra.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Model Datasets > List all datasets associated with a model. ## OpenAPI ````yaml get /v1/models/{model_id}/datasets openapi: 3.1.0 info: title: Cuadra AI API description: >- REST API for AI-powered chat, RAG, and multi-channel messaging. Full documentation at https://docs.cuadra.ai version: 1.0.0 contact: name: Cuadra AI Support url: https://cuadra.ai/support email: support@cuadra.ai license: name: Proprietary url: https://cuadra.ai/terms termsOfService: https://cuadra.ai/terms servers: - url: https://api.cuadra.ai description: Production security: - bearerAuth: [] - oauth2: [] tags: - name: Health description: >- System health monitoring and readiness checks. Essential for load balancers and deployment automation. - name: Models description: >- Manage custom AI model configurations derived from base models. Create, update, and delete with flexible pricing and token limits. - name: Chats description: >- Interact with AI models for intelligent chat completions. Supports streaming and non-streaming modes with message history. - name: Files description: >- Manage file uploads for chat attachments and dataset knowledge bases. Supports automatic processing, chunking, and embedding for RAG. - name: Datasets description: >- Manage RAG knowledge base datasets with versioning and semantic search. Organize uploaded files into searchable knowledge bases. - name: Particles description: >- Manage reusable system prompt particles for AI model behavior. Particles are modular components (role, tone, guardrails, constraints, format) that compose into system prompts. - name: System Prompts description: >- Compose particles into complete system prompts for AI models. System prompts define model behavior through ordered particle compositions with support for version pinning and token budget validation. - name: Usage description: >- Monitor and analyze API usage with detailed token counting. Track usage across models, tenants, and time periods. - name: Artifacts description: >- Manage rich content artifacts generated during chat conversations. Supports markdown, code, HTML, SVG, and Mermaid diagrams. paths: /v1/models/{model_id}/datasets: get: tags: - Models summary: List Model Datasets description: List all datasets associated with a model. operationId: listModelDatasets parameters: - name: model_id in: path required: true schema: type: string description: Model ID examples: - model_abc123 title: Model Id description: Model ID - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque cursor title: Cursor description: Opaque cursor responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ModelDatasetPage' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ModelDatasetPage: properties: items: items: $ref: '#/components/schemas/ModelDatasetOut' type: array title: Items description: List of model-dataset associations in this page nextCursor: anyOf: - type: string - type: 'null' title: Nextcursor description: Cursor for the next page of results hasMore: type: boolean title: Hasmore description: Whether there are more results available totalCount: anyOf: - type: integer - type: 'null' title: Totalcount description: Total count of associations (if available) type: object required: - items - hasMore title: ModelDatasetPage description: Paginated response for model-dataset associations. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ModelDatasetOut: properties: modelId: type: string title: Modelid description: ID of the model examples: - 550e8400-e29b-41d4-a716-446655440000 datasetId: type: string title: Datasetid description: ID of the associated dataset examples: - 550e8400-e29b-41d4-a716-446655440001 usageType: type: string title: Usagetype description: How the dataset is used examples: - rag datasetSnapshotId: anyOf: - type: string - type: 'null' title: Datasetsnapshotid description: Specific dataset snapshot ID (null = use latest, value = pinned) priority: type: integer title: Priority description: Priority for this dataset examples: - 0 - 1 - 10 createdAt: type: string format: date-time title: Createdat description: When the association was created examples: - '2025-10-18T06:33:19Z' updatedAt: type: string format: date-time title: Updatedat description: When the association was last updated examples: - '2025-10-18T06:33:19Z' type: object required: - modelId - datasetId - usageType - priority - createdAt - updatedAt title: ModelDatasetOut description: Schema for model-dataset association response. example: createdAt: '2025-10-18T06:33:19Z' datasetId: 550e8400-e29b-41d4-a716-446655440001 modelId: 550e8400-e29b-41d4-a716-446655440000 priority: 0 updatedAt: '2025-10-18T06:33:19Z' usageType: rag ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT token from Stytch B2B authentication (magic link, SSO, or M2M) oauth2: type: oauth2 flows: clientCredentials: tokenUrl: https://auth.cuadra.ai/oauth/token scopes: chats:invoke: Invoke chat completions (billable) chats:read: Read and list chats chats:write: Create and update chats chats:delete: Delete chats chats:admin: Full chat access (read/write/delete/invoke) models:read: Read model configurations models:write: Create and update models models:delete: Delete models models:admin: Full access to models (grants read + write + delete) datasets:read: Read and list datasets and snapshots datasets:write: Create and update datasets and snapshots datasets:delete: Delete datasets and snapshots datasets:admin: Full dataset access (read/write/delete) files:read: Read, list, and download files files:write: Upload, associate, and reprocess files files:delete: Delete files (single and bulk) files:admin: Full access to files (grants read + write + delete) particles:read: View particles and particle versions particles:write: Create and update particles particles:delete: Delete particles particles:admin: Full particle access (read/write/delete) system-prompts:read: View system prompts and compositions system-prompts:write: Create and update system prompts system-prompts:delete: Delete system prompts system-prompts:admin: Full system prompt access (read/write/delete) usage:read: Read usage and billing information usage:admin: Full access to usage data (grants read) connections:read: View external connections and sync status connections:write: Create and update external connections connections:delete: Delete connections and sync configurations connections:admin: Full connection access (read/write/delete) channels:read: View channels and channel configuration channels:write: Create and update channels channels:delete: Delete channels and release phone numbers channels:admin: Full channel access (read/write/delete) org:admin: Full resource access, manage members org:owner: 'Owner: all access including billing' chat:write: Delete and manage chats ````