DatasetGetManyResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/coactive/main/json-schema/coactive-datasets-dataset-get-many-response-schema.json",
  "title": "DatasetGetManyResponse",
  "x-generated": "2026-10-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/coactive-datasets-dataset-api-openapi.yml#/components/schemas/datasets_DatasetGetManyResponse",
  "type": "object",
  "properties": {
    "meta": {
      "oneOf": [
        {
          "$ref": "#/$defs/datasets_PagedMetaResponse"
        },
        {
          "type": "null"
        }
      ],
      "description": "Metadata for the set of data returned"
    },
    "data": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/datasets_DatasetResponse"
      },
      "description": "The paginated data"
    }
  },
  "required": [
    "meta",
    "data"
  ],
  "$defs": {
    "datasets_AssetTypeEnum": {
      "type": "string",
      "enum": [
        "image",
        "video"
      ],
      "description": "Indicates the type of asset",
      "title": "AssetTypeEnum"
    },
    "datasets_CompositeSettings": {
      "type": "object",
      "properties": {
        "maximum_slice_duration_seconds": {
          "type": "integer",
          "description": "Maximum duration in seconds for a single composite slice."
        }
      },
      "required": [
        "maximum_slice_duration_seconds"
      ],
      "title": "CompositeSettings"
    },
    "datasets_DatasetConfig": {
      "type": "object",
      "properties": {
        "embedding_id": {
          "type": "object",
          "additionalProperties": {
            "type": "string",
            "format": "uuid"
          },
          "description": "Mapping from encoder modality to the UUID of the embedding model used for that modality."
        },
        "encoder_name": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Mapping from encoder modality to the name of the encoder model used for that modality."
        },
        "extra_config": {
          "oneOf": [
            {
              "$ref": "#/$defs/datasets_ExtraConfig"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional extra configuration for composite types."
        },
        "hybrid_search": {
          "oneOf": [
            {
              "$ref": "#/$defs/datasets_HybridSearchConfig"
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional hybrid search configuration specifying modality weights."
        },
        "context_studio_enabled": {
          "type": [
            "boolean",
            "null"
          ],
          "default": false,
          "description": "Whether Context Studio is enabled for this dataset."
        },
        "metadata_fields_to_embed": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          },
          "description": "Metadata fields whose values are embedded."
        },
        "metadata_fields_to_index": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          },
          "description": "Metadata fields that are indexed for filtering and search."
        },
        "celebrity_detection_enabled": {
          "type": [
            "boolean",
            "null"
          ],
          "default": false,
          "description": "Whether celebrity detection is enabled for this dataset."
        },
        "agentic_search_metadata_description": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": {
            "type": "string"
          },
          "description": "Per-key descriptions of metadata fields."
        },
        "asset_identifier_key": {
          "type": [
            "string",
            "null"
          ],
          "description": "The metadata field name that uniquely identifies each asset in the dataset."
        },
        "context_studio_export_json_connection_name": {
          "type": [
            "string",
            "null"
          ],
          "description": "The name of the connection required for external s3 export. (this is related to context_studio feature)."
        }
      },
      "required": [
        "embedding_id",
        "encoder_name"
      ],
      "title": "DatasetConfig"
    },
    "datasets_DatasetResponse": {
      "type": "object",
      "properties": {
        "created_dt": {
          "type": "string",
          "format": "date-time",
          "description": "The created datetime of the resource in ISO 8601 format."
        },
        "updated_dt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "The datetime the resource was last updated in ISO 8601 format."
        },
        "created_by": {
          "type": "string",
          "description": "ID of the user who added the asset to the dataset."
        },
        "updated_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "ID of the user who last updated the asset."
        },
        "deleted_dt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "Timestamp if the resource was deleted."
        },
        "deleted_by": {
          "type": [
            "string",
            "null"
          ],
          "description": "ID of the user who deleted the resource."
        },
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "The unique identifier for the dataset."
        },
        "name": {
          "type": "string",
          "description": "Name of the dataset, must be unique per organization and must only contain alphanumeric and underscore characters."
        },
        "embeddings": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/datasets_Encoder"
          },
          "description": "The encoders of the dataset."
        },
        "encoders": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/datasets_Encoder"
          },
          "description": "The encoders of the dataset."
        },
        "description": {
          "type": [
            "string",
            "null"
          ],
          "description": "A short summary of what the dataset includes or is intended for."
        },
        "allowed_asset_types": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/datasets_AssetTypeEnum"
          },
          "description": "Types of assets allowed in this dataset."
        },
        "status": {
          "oneOf": [
            {
              "$ref": "#/$defs/datasets_DatasetStatusEnum"
            },
            {
              "type": "null"
            }
          ],
          "description": "The status of the dataset."
        },
        "keyframe_sampling_method": {
          "$ref": "#/$defs/datasets_KeyframeSamplingMethodEnum",
          "description": "Sampling method to extract keyframes from videos in dataset."
        },
        "keyframe_uniform_fps_sampling_rate": {
          "type": [
            "number",
            "null"
          ],
          "format": "double",
          "description": "FPS rate used for uniform sampling."
        },
        "store_original": {
          "type": "boolean",
          "description": "Whether the original file is stored."
        },
        "store_preview": {
          "type": "boolean",
          "description": "Whether preview files are stored."
        },
        "metadata_fields_to_index": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          },
          "description": "The metadata fields to index for the dataset."
        },
        "metadata_fields_to_embed": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          },
          "description": "The metadata fields to embed for the dataset."
        },
        "dataset_config": {
          "oneOf": [
            {
              "$ref": "#/$defs/datasets_DatasetConfig"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "created_dt",
        "created_by",
        "id",
        "name",
        "embeddings",
        "encoders",
        "description",
        "allowed_asset_types",
        "status",
        "keyframe_sampling_method",
        "store_original",
        "store_preview"
      ],
      "title": "DatasetResponse"
    },
    "datasets_DatasetStatusEnum": {
      "type": "string",
      "enum": [
        "active",
        "inactive",
        "deleting",
        "deleted"
      ],
      "description": "Indicates the operational status of a dataset",
      "title": "DatasetStatusEnum"
    },
    "datasets_Encoder": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid",
          "description": "The unique identifier for the encoder."
        },
        "name": {
          "$ref": "#/$defs/datasets_EncoderName",
          "description": "The model used to extract visual and audio features from assets."
        },
        "modality": {
          "type": "string",
          "description": "The supported modality of the encoder."
        },
        "modalities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The supported modalities of the encoder."
        }
      },
      "required": [
        "id",
        "name",
        "modality",
        "modalities"
      ],
      "title": "Encoder"
    },
    "datasets_EncoderName": {
      "oneOf": [
        {
          "$ref": "#/$defs/datasets_VisualEncoderNameEnum"
        },
        {
          "type": "string"
        }
      ],
      "description": "The model used to extract visual and audio features from assets.",
      "title": "EncoderName"
    },
    "datasets_ExtraConfig": {
      "type": "object",
      "properties": {
        "composite_settings": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/$defs/datasets_CompositeSettings"
          },
          "description": "Mapping of composite type name to its settings."
        }
      },
      "required": [
        "composite_settings"
      ],
      "title": "ExtraConfig"
    },
    "datasets_HybridSearchConfig": {
      "type": "object",
      "properties": {
        "weights": {
          "type": "object",
          "additionalProperties": {
            "type": "number",
            "format": "double"
          },
          "description": "Weights for each modality used in hybrid search scoring."
        }
      },
      "required": [
        "weights"
      ],
      "title": "HybridSearchConfig"
    },
    "datasets_KeyframeSamplingMethodEnum": {
      "type": "string",
      "enum": [
        "intelligent",
        "uniform"
      ],
      "description": "Indicates the method used to sample keyframes from a video",
      "title": "KeyframeSamplingMethodEnum"
    },
    "datasets_PagedMetaResponse": {
      "type": "object",
      "properties": {
        "page": {
          "$ref": "#/$defs/datasets_PagedPageDetailsResponse",
          "description": "Details about the total set of data"
        }
      },
      "required": [
        "page"
      ],
      "description": "Metadata about the paginated response",
      "title": "PagedMetaResponse"
    },
    "datasets_PagedPageDetailsResponse": {
      "type": "object",
      "properties": {
        "current_page": {
          "type": "integer",
          "description": "Current page number"
        },
        "last_page": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Max page number based on limit and total number of items"
        },
        "limit": {
          "type": "integer",
          "description": "Number of items to return"
        },
        "offset": {
          "type": "integer",
          "description": "Starting index to return"
        },
        "total": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Total number of items"
        }
      },
      "required": [
        "current_page",
        "last_page",
        "limit",
        "offset",
        "total"
      ],
      "description": "Pagination metadata",
      "title": "PagedPageDetailsResponse"
    },
    "datasets_VisualEncoderNameEnum": {
      "type": "string",
      "enum": [
        "multimodal",
        "multimodal-tx-large2",
        "multimodal-tx-large3",
        "multimodal-tx-large4",
        "nova2-multimodal",
        "resnet-50",
        "resnet-50-reduced"
      ],
      "title": "VisualEncoderNameEnum"
    }
  }
}