> ## Documentation Index > Fetch the complete documentation index at: https://docs.galileo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Query Datasets ## OpenAPI ````yaml https://api.galileo.ai/public/v2/openapi.json post /v2/datasets/query openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://api.galileo.ai description: Galileo Public APIs - galileo-v2 security: [] paths: /v2/datasets/query: post: tags: - datasets summary: Query Datasets operationId: query_datasets_v2_datasets_query_post parameters: - name: actions in: query required: false schema: type: array items: $ref: '#/components/schemas/DatasetAction' description: Actions to include in the 'permissions' field. title: Actions description: Actions to include in the 'permissions' field. - name: starting_token in: query required: false schema: type: integer title: Starting Token default: 0 - name: limit in: query required: false schema: type: integer title: Limit default: 100 requestBody: content: application/json: schema: $ref: '#/components/schemas/ListDatasetParams' default: filters: [] sort: name: created_at ascending: false sort_type: column responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ListDatasetResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] - OAuth2PasswordBearer: [] - HTTPBasic: [] components: schemas: DatasetAction: type: string enum: - update - delete - share - export - rename title: DatasetAction ListDatasetParams: properties: filters: items: oneOf: - $ref: '#/components/schemas/DatasetNameFilter' - $ref: '#/components/schemas/DatasetDraftFilter' - $ref: '#/components/schemas/DatasetUsedInProjectFilter' - $ref: '#/components/schemas/DatasetIDFilter' - $ref: '#/components/schemas/DatasetNotInProjectFilter' discriminator: propertyName: name mapping: draft: $ref: '#/components/schemas/DatasetDraftFilter' id: $ref: '#/components/schemas/DatasetIDFilter' name: $ref: '#/components/schemas/DatasetNameFilter' not_in_project: $ref: '#/components/schemas/DatasetNotInProjectFilter' used_in_project: $ref: '#/components/schemas/DatasetUsedInProjectFilter' type: array title: Filters sort: anyOf: - oneOf: - $ref: '#/components/schemas/DatasetNameSort' - $ref: '#/components/schemas/DatasetCreatedAtSort' - $ref: '#/components/schemas/DatasetUpdatedAtSort' - $ref: '#/components/schemas/DatasetProjectLastUsedAtSort' - $ref: '#/components/schemas/DatasetProjectsSort' - $ref: '#/components/schemas/DatasetRowsSort' - $ref: '#/components/schemas/DatasetLastEditedByUserAtSort' discriminator: propertyName: name mapping: created_at: $ref: '#/components/schemas/DatasetCreatedAtSort' last_edited_by_user_at: $ref: '#/components/schemas/DatasetLastEditedByUserAtSort' name: $ref: '#/components/schemas/DatasetNameSort' num_rows: $ref: '#/components/schemas/DatasetRowsSort' project_count: $ref: '#/components/schemas/DatasetProjectsSort' project_last_used_at: $ref: '#/components/schemas/DatasetProjectLastUsedAtSort' updated_at: $ref: '#/components/schemas/DatasetUpdatedAtSort' - type: 'null' title: Sort default: name: created_at ascending: false sort_type: column type: object title: ListDatasetParams ListDatasetResponse: properties: starting_token: type: integer title: Starting Token default: 0 limit: type: integer title: Limit default: 100 paginated: type: boolean title: Paginated default: false next_starting_token: anyOf: - type: integer - type: 'null' title: Next Starting Token datasets: items: $ref: '#/components/schemas/DatasetDB' type: array title: Datasets type: object title: ListDatasetResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError DatasetNameFilter: properties: name: type: string const: name title: Name default: name operator: type: string enum: - eq - ne - contains - one_of - not_in title: Operator value: anyOf: - type: string - items: type: string type: array title: Value case_sensitive: type: boolean title: Case Sensitive default: true type: object required: - operator - value title: DatasetNameFilter DatasetDraftFilter: properties: name: type: string const: draft title: Name default: draft operator: type: string enum: - eq - ne title: Operator default: eq value: type: boolean title: Value type: object required: - value title: DatasetDraftFilter DatasetUsedInProjectFilter: properties: name: type: string const: used_in_project title: Name default: used_in_project value: type: string format: uuid4 title: Value type: object required: - value title: DatasetUsedInProjectFilter DatasetIDFilter: properties: name: type: string const: id title: Name default: id operator: type: string enum: - eq - ne - one_of - not_in - contains title: Operator default: eq value: anyOf: - type: string format: uuid4 - items: anyOf: - type: string format: uuid4 - type: string type: array - type: string title: Value type: object required: - value title: DatasetIDFilter DatasetNotInProjectFilter: properties: name: type: string const: not_in_project title: Name default: not_in_project value: type: string format: uuid4 title: Value type: object required: - value title: DatasetNotInProjectFilter DatasetNameSort: properties: name: type: string const: name title: Name default: name ascending: type: boolean title: Ascending default: true sort_type: type: string const: column title: Sort Type default: column type: object title: DatasetNameSort DatasetCreatedAtSort: properties: name: type: string const: created_at title: Name default: created_at ascending: type: boolean title: Ascending default: true sort_type: type: string const: column title: Sort Type default: column type: object title: DatasetCreatedAtSort DatasetUpdatedAtSort: properties: name: type: string const: updated_at title: Name default: updated_at ascending: type: boolean title: Ascending default: true sort_type: type: string const: column title: Sort Type default: column type: object title: DatasetUpdatedAtSort DatasetProjectLastUsedAtSort: properties: name: type: string const: project_last_used_at title: Name default: project_last_used_at ascending: type: boolean title: Ascending default: true sort_type: type: string const: custom_uuid title: Sort Type default: custom_uuid value: type: string format: uuid4 title: Value type: object required: - value title: DatasetProjectLastUsedAtSort DatasetProjectsSort: properties: name: type: string const: project_count title: Name default: project_count ascending: type: boolean title: Ascending default: true sort_type: type: string const: custom title: Sort Type default: custom type: object title: DatasetProjectsSort DatasetRowsSort: properties: name: type: string const: num_rows title: Name default: num_rows ascending: type: boolean title: Ascending default: true sort_type: type: string const: column title: Sort Type default: column type: object title: DatasetRowsSort DatasetLastEditedByUserAtSort: properties: name: type: string const: last_edited_by_user_at title: Name default: last_edited_by_user_at ascending: type: boolean title: Ascending default: true sort_type: type: string const: custom_uuid title: Sort Type default: custom_uuid value: type: string format: uuid4 title: Value type: object required: - value title: DatasetLastEditedByUserAtSort DatasetDB: properties: id: type: string format: uuid4 title: Id permissions: items: $ref: '#/components/schemas/Permission' type: array title: Permissions default: [] name: type: string title: Name created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At project_count: type: integer title: Project Count num_rows: anyOf: - type: integer - type: 'null' title: Num Rows column_names: anyOf: - items: type: string type: array - type: 'null' title: Column Names created_by_user: anyOf: - $ref: '#/components/schemas/UserInfo' - type: 'null' current_version_index: type: integer title: Current Version Index draft: type: boolean title: Draft type: object required: - id - name - created_at - updated_at - project_count - num_rows - column_names - created_by_user - current_version_index - draft title: DatasetDB 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 Permission: properties: action: anyOf: - $ref: '#/components/schemas/UserAction' - $ref: '#/components/schemas/GroupAction' - $ref: '#/components/schemas/GroupMemberAction' - $ref: '#/components/schemas/ProjectAction' - $ref: '#/components/schemas/RegisteredScorerAction' - $ref: '#/components/schemas/ApiKeyAction' - $ref: '#/components/schemas/GeneratedScorerAction' - $ref: '#/components/schemas/FineTunedScorerAction' - $ref: '#/components/schemas/DatasetAction' - $ref: '#/components/schemas/IntegrationAction' - $ref: '#/components/schemas/OrganizationAction' - $ref: '#/components/schemas/AnnotationQueueAction' title: Action allowed: type: boolean title: Allowed message: anyOf: - type: string - type: 'null' title: Message type: object required: - action - allowed title: Permission UserInfo: properties: id: type: string format: uuid4 title: Id email: type: string title: Email first_name: anyOf: - type: string - type: 'null' title: First Name last_name: anyOf: - type: string - type: 'null' title: Last Name type: object required: - id - email title: UserInfo description: A user's basic information, used for display purposes. UserAction: type: string enum: - update - delete - read_api_keys - change_role_to_admin - change_role_to_manager - change_role_to_user - change_role_to_read_only title: UserAction GroupAction: type: string enum: - update - list_members - join - request_to_join title: GroupAction GroupMemberAction: type: string enum: - update_role - delete title: GroupMemberAction ProjectAction: type: string enum: - update - delete - rename - share - create_run - delete_run - rename_run - move_run - export_data - configure_human_feedback - record_human_feedback - log_data - toggle_metric - edit_alert - create_stage - edit_stage - configure_crown_logic - delete_data - set_metric - edit_run_tags - dismiss_alert - edit_slice - edit_edit title: ProjectAction RegisteredScorerAction: type: string enum: - update - delete title: RegisteredScorerAction ApiKeyAction: type: string enum: - update - delete title: ApiKeyAction GeneratedScorerAction: type: string enum: - update - delete title: GeneratedScorerAction FineTunedScorerAction: type: string enum: - update - delete title: FineTunedScorerAction IntegrationAction: type: string enum: - update - delete - share title: IntegrationAction OrganizationAction: type: string enum: - rename - delete - delete_log_data - read_settings - update_settings title: OrganizationAction AnnotationQueueAction: type: string enum: - update - delete - share - record_annotation title: AnnotationQueueAction securitySchemes: APIKeyHeader: type: apiKey in: header name: Galileo-API-Key OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: https://api.galileo.ai/login HTTPBasic: type: http scheme: basic ````