# Product Collections

## Retrieve Product Collection

> Retrieve a specific product collection by ID

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/{id}/":{"get":{"summary":"Retrieve Product Collection","description":"Retrieve a specific product collection by ID","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/id_path"},{"$ref":"#/components/parameters/hyper"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProductCollection"},{"$ref":"#/components/schemas/ProductCollectionHyperSerializer"}]}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Update Product Collection

> Update an existing product collection

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/{id}/":{"put":{"summary":"Update Product Collection","description":"Update an existing product collection","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/id_path"},{"$ref":"#/components/parameters/hyper"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","collection_type","catalog"],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection"},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProductCollection"},{"$ref":"#/components/schemas/ProductCollectionHyperSerializer"}]}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Delete Product Collection

> Delete an existing product collection

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/{id}/":{"delete":{"summary":"Delete Product Collection","description":"Delete an existing product collection","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/id_path"}],"responses":{"204":{"description":"No Content"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Partial Update Product Collection

> Partially update an existing product collection

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"id_path":{"name":"id","in":"path","description":"Unique identifier of the resource","required":true,"schema":{"type":"integer"}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/{id}/":{"patch":{"summary":"Partial Update Product Collection","description":"Partially update an existing product collection","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/id_path"},{"$ref":"#/components/parameters/hyper"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection"},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"is_active":{"type":"boolean","description":"Whether the product collection is active"},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProductCollection"},{"$ref":"#/components/schemas/ProductCollectionHyperSerializer"}]}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Retrieve Detailed Product Collection

> Retrieve a specific product collection with detailed information

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollectionDetailedSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"catalog":{"type":"object","description":"Catalog object"},"sort_option":{"type":"object","description":"Sort option object"}}},"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionDetailedHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/{id}/detailed/":{"get":{"summary":"Retrieve Detailed Product Collection","description":"Retrieve a specific product collection with detailed information","tags":["Product Collections"],"parameters":[{"name":"id","in":"path","required":true,"description":"A unique integer value identifying this product collection.","schema":{"type":"integer"}},{"$ref":"#/components/parameters/hyper"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"},{"$ref":"#/components/schemas/ProductCollectionDetailedHyperSerializer"}]}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List Product Collections

> List all product collections

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"Specifies the page number of the current dataset","schema":{"type":"integer","minimum":1,"default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"Indicates the number of rows on the current page.","schema":{"type":"integer","minimum":1,"default":10}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/":{"get":{"summary":"List Product Collections","description":"List all product collections","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/hyper"},{"name":"catalog","in":"query","description":"Filter by catalog ID","schema":{"type":"integer"}},{"name":"collection_type","in":"query","description":"Filter by collection type","schema":{"type":"string","enum":["static","dynamic"]}},{"name":"expiration_date__gt","in":"query","description":"Filter by expiration date greater than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__gte","in":"query","description":"Filter by expiration date greater than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lt","in":"query","description":"Filter by expiration date less than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lte","in":"query","description":"Filter by expiration date less than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__isnull","in":"query","description":"Filter by whether expiration date is null","schema":{"type":"boolean"}},{"name":"pk__in","in":"query","description":"Filter by multiple IDs (comma-separated)","schema":{"type":"string"}},{"name":"is_active","in":"query","description":"Filter by active status","schema":{"type":"boolean"}},{"name":"name","in":"query","description":"Filter by name","schema":{"type":"string"}},{"name":"slug","in":"query","description":"Filter by slug","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","description":"Next page URL","nullable":true},"previous":{"type":"string","description":"Previous page URL","nullable":true},"results":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ProductCollection"},{"$ref":"#/components/schemas/ProductCollectionHyperSerializer"}]}}}}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## Create Product Collection

> Create a new product collection

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"400":{"description":"Required field(s) are missing, data is invalid, or the action is not allowed.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"field":{"oneOf":[{"type":"array","description":"Indicates that no value was provided for the {field} field in the request.","items":{"type":"string"}},{"type":"array","description":"Indicates usage of a non-existent object for {field} in the request.","items":{"type":"string"}}]},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"non_field_errors":{"description":"Indicates invalid data or action usage in the request.","type":"array","items":{"type":"string"}},"code":{"type":"string","description":"Represents the server-side error code."}}},{"type":"object","properties":{"detail":{"description":"Provides a detailed message for the given error.","type":"string"},"code":{"type":"string","description":"Represents the server-side error code."}}}]}}}},"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/":{"post":{"summary":"Create Product Collection","description":"Create a new product collection","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/hyper"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","collection_type","catalog"],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection"},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}}}}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ProductCollection"},{"$ref":"#/components/schemas/ProductCollectionHyperSerializer"}]}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List Product Collections with details

> List product collections with detailed information

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"Specifies the page number of the current dataset","schema":{"type":"integer","minimum":1,"default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"Indicates the number of rows on the current page.","schema":{"type":"integer","minimum":1,"default":10}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollectionDetailedSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"catalog":{"type":"object","description":"Catalog object"},"sort_option":{"type":"object","description":"Sort option object"}}},"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionDetailedHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/detailed/":{"get":{"summary":"List Product Collections with details","description":"List product collections with detailed information","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/hyper"},{"name":"catalog","in":"query","description":"Filter by catalog ID","schema":{"type":"integer"}},{"name":"collection_type","in":"query","description":"Filter by collection type","schema":{"type":"string","enum":["static","dynamic"]}},{"name":"expiration_date__gt","in":"query","description":"Filter by expiration date greater than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__gte","in":"query","description":"Filter by expiration date greater than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lt","in":"query","description":"Filter by expiration date less than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lte","in":"query","description":"Filter by expiration date less than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__isnull","in":"query","description":"Filter by whether expiration date is null","schema":{"type":"boolean"}},{"name":"pk__in","in":"query","description":"Filter by multiple IDs (comma-separated)","schema":{"type":"string"}},{"name":"is_active","in":"query","description":"Filter by active status","schema":{"type":"boolean"}},{"name":"name","in":"query","description":"Filter by name","schema":{"type":"string"}},{"name":"slug","in":"query","description":"Filter by slug","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","description":"Next page URL","nullable":true},"previous":{"type":"string","description":"Previous page URL","nullable":true},"results":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"},{"$ref":"#/components/schemas/ProductCollectionDetailedHyperSerializer"}]}}}}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## List Product Collections with details (detailed\_list action)

> List product collections with detailed information using the detailed\_list action

```json
{"openapi":"3.0.3","info":{"title":"Omnitron API","version":"1.0.0"},"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"type":"apiKey","in":"header","name":"Authorization"}},"parameters":{"page":{"name":"page","in":"query","required":false,"description":"Specifies the page number of the current dataset","schema":{"type":"integer","minimum":1,"default":1}},"limit":{"name":"limit","in":"query","required":false,"description":"Indicates the number of rows on the current page.","schema":{"type":"integer","minimum":1,"default":10}},"hyper":{"name":"hyper","in":"query","description":"Activate id to hyperlink the response data.","required":false,"schema":{"type":"boolean"}}},"schemas":{"ProductCollectionDetailedSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollection"}],"properties":{"catalog":{"type":"object","description":"Catalog object"},"sort_option":{"type":"object","description":"Sort option object"}}},"ProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/BaseProductCollection"},{"$ref":"#/components/schemas/IntegrationRelation"}],"properties":{"uuid":{"type":"string","format":"uuid","description":"Unique identifier for the product collection"},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":false},"catalog":{"type":"integer","description":"Foreign key to Catalog model"},"kwargs":{"type":"object","description":"Dynamic configuration stored as JSON","additionalProperties":true},"value_dict":{"type":"object","description":"Dictionary of filter values for dynamic collections","additionalProperties":true},"selected_filters":{"type":"array","description":"List of selected filters for the collection","items":{"type":"string"}},"is_dynamic":{"type":"boolean","description":"Whether the collection is dynamic","readOnly":true}}},"BaseProductCollection":{"type":"object","allOf":[{"$ref":"#/components/schemas/StarterModel"}],"properties":{"name":{"type":"string","description":"Name of the product collection","maxLength":255},"slug":{"type":"string","description":"Unique slug identifier for the product collection","maxLength":255},"is_active":{"type":"boolean","description":"Whether the product collection is active","default":true},"sort_option":{"type":"integer","description":"Foreign key to SortOption model","nullable":true},"expiration_date":{"type":"string","format":"date-time","description":"Date and time when the collection expires","nullable":true},"collection_type":{"type":"string","enum":["static","dynamic"],"description":"Type of the product collection","nullable":true}}},"StarterModel":{"type":"object","properties":{"created_date":{"type":"string","format":"date-time","readOnly":true,"description":"The date and time when the object was created."},"modified_date":{"type":"string","format":"date-time","description":"The date and time when the object was last modified."}}},"IntegrationRelation":{"type":"object","properties":{"integration":{"type":"array","description":"Integration actions associated with the object.","items":{"$ref":"#/components/schemas/IntegrationAction"}}}},"IntegrationAction":{"type":"object","properties":{"channel":{"$ref":"#/components/schemas/Channel"},"content_type":{"$ref":"#/components/schemas/ContentType"},"object_id":{"type":"integer","description":"ID of the related object (used with GenericForeignKey)"},"remote_id":{"type":"string","maxLength":255,"nullable":true},"version_date":{"type":"string","format":"date-time","description":"The version date of the action"},"state":{"type":"object","description":"JSON representation of the state"},"local_batch_id":{"type":"string","maxLength":255,"nullable":true},"status":{"$ref":"#/components/schemas/IntegrationActionStatus"},"content_object":{"type":"object","nullable":true,"description":"Generic foreign key, handled dynamically"}}},"Channel":{"type":"object","required":["name","catalog","channel_type","conf","is_active"],"properties":{"id":{"type":"integer","readOnly":true},"name":{"type":"string","maxLength":255},"catalog":{"type":"integer"},"channel_type":{"type":"string","description":"The type of channel. ex: web, distributed, hepsiburada, etc.","enum":["hepsiburada","hepsiburadads","gittigidiyor","n11","web","feed","trendyol","morhipo","morhipoV2","lidyana","amazon","allegro","distributed","aliexpress","emag","ciceksepeti","gordumaldim","pazarama","flo","turkcellds","sales_channel"]},"conf":{"type":"object","description":"A JSON object containing configuration settings for the channel.","additionalProperties":{"type":"string"}},"category_tree":{"type":"string","nullable":true,"description":"The category tree related to this channel."},"is_active":{"type":"boolean","description":"Specifies whether the channel is active.","default":true},"schema":{"type":"object","description":"Additional schema information for the channel.","nullable":true},"created_date":{"type":"string","format":"date-time","readOnly":true},"modified_date":{"type":"string","format":"date-time"}}},"ContentType":{"type":"object","properties":{"id":{"type":"integer","readOnly":true,"description":"Content Type ID"},"app_label":{"type":"string","description":"App label for the content type"},"model":{"type":"string","description":"Model for the content type"}},"required":["app_label","model"]},"IntegrationActionStatus":{"type":"string","enum":["processing","success","error"],"description":"Status of the integration action"},"ProductCollectionDetailedHyperSerializer":{"type":"object","allOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"}],"properties":{"url":{"type":"string","format":"uri","description":"URL for the product collection"},"catalog":{"type":"string","format":"uri","description":"URL for the catalog"},"sort_option":{"type":"string","format":"uri","description":"URL for the sort option","nullable":true}}}},"responses":{"401":{"description":"Unauthorized Access","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","description":"Contains a detailed description of the error."},"code":{"type":"string","description":"Represents the server-side error code."}}}}}},"404":{"description":"The given resource or object was not found or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"description":"Contains a detailed description of the error.","type":"string"}}}}}},"500":{"description":"Server Error"}}},"paths":{"/api/v1/product_collections/detailed_list/":{"get":{"summary":"List Product Collections with details (detailed_list action)","description":"List product collections with detailed information using the detailed_list action","tags":["Product Collections"],"parameters":[{"$ref":"#/components/parameters/page"},{"$ref":"#/components/parameters/limit"},{"$ref":"#/components/parameters/hyper"},{"name":"catalog","in":"query","description":"Filter by catalog ID","schema":{"type":"integer"}},{"name":"collection_type","in":"query","description":"Filter by collection type","schema":{"type":"string","enum":["static","dynamic"]}},{"name":"expiration_date__gt","in":"query","description":"Filter by expiration date greater than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__gte","in":"query","description":"Filter by expiration date greater than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lt","in":"query","description":"Filter by expiration date less than","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__lte","in":"query","description":"Filter by expiration date less than or equal to","schema":{"type":"string","format":"date-time"}},{"name":"expiration_date__isnull","in":"query","description":"Filter by whether expiration date is null","schema":{"type":"boolean"}},{"name":"pk__in","in":"query","description":"Filter by multiple IDs (comma-separated)","schema":{"type":"string"}},{"name":"is_active","in":"query","description":"Filter by active status","schema":{"type":"boolean"}},{"name":"name","in":"query","description":"Filter by name","schema":{"type":"string"}},{"name":"slug","in":"query","description":"Filter by slug","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"next":{"type":"string","description":"Next page URL","nullable":true},"previous":{"type":"string","description":"Previous page URL","nullable":true},"results":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/ProductCollectionDetailedSerializer"},{"$ref":"#/components/schemas/ProductCollectionDetailedHyperSerializer"}]}}}}}}},"401":{"$ref":"#/components/responses/401"},"404":{"$ref":"#/components/responses/404"},"500":{"$ref":"#/components/responses/500"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/omnitron-openapis/product-collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.