ds-public¶
API for Deep Search.
WARNING: This API is subject to change without warning!
This Python package is automatically generated by the OpenAPI Generator project:
- API version: 3.0.0
- Package version: 2.0.0
- Generator version: 7.4.0
- Build package: org.openapitools.codegen.languages.PythonClientCodegen
Requirements.¶
Python 3.7+
Installation & Usage¶
pip install¶
If the python package is hosted on a repository, you can install directly using:
(you may need to runpip
with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
)
Then import the package:
Setuptools¶
Install via Setuptools.
(orsudo python setup.py install
to install the package for all users)
Then import the package:
Tests¶
Execute pytest
to run the tests.
Getting Started¶
Please follow the installation procedure and then run the following:
import deepsearch.cps.apis.public_v2
from deepsearch.cps.apis.public_v2.rest import ApiException
from pprint import pprint
# Defining the host is optional and defaults to /api/cps/public/v2
# See configuration.py for a list of all supported configuration parameters.
configuration = deepsearch.cps.apis.public_v2.Configuration(
host = "/api/cps/public/v2"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure API key authorization: Bearer
configuration.api_key['Bearer'] = os.environ["API_KEY"]
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['Bearer'] = 'Bearer'
# Enter a context with an instance of the API client
with deepsearch.cps.apis.public_v2.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = deepsearch.cps.apis.public_v2.ContentManagerApi(api_client)
index_key = 'index_key_example' # str |
document_hash = 'document_hash_example' # str |
proj_key = 'proj_key_example' # str |
document_meta = deepsearch.cps.apis.public_v2.DocumentMeta() # DocumentMeta |
try:
# Add Project Data Index Document Metadata
api_instance.add_project_data_index_document_metadata(index_key, document_hash, proj_key, document_meta)
except ApiException as e:
print("Exception when calling ContentManagerApi->add_project_data_index_document_metadata: %s\n" % e)
Documentation for API Endpoints¶
All URIs are relative to /api/cps/public/v2
Class | Method | HTTP request | Description |
---|---|---|---|
ContentManagerApi | add_project_data_index_document_metadata | POST /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/metadata | Add Project Data Index Document Metadata |
ContentManagerApi | get_all_project_data_index_documents | GET /project/{proj_key}/data_indices/{index_key}/documents/ | Get All Project Data Index Documents |
ContentManagerApi | get_project_agents | GET /project/{proj_key}/data_indices/documents/agents | Get Project Agents |
ContentManagerApi | get_project_conversion_statistics | GET /project/{proj_key}/data_indices/{index_key}/documents/statistics | Get Project Conversion Statistics |
ContentManagerApi | get_project_data_index_document_artifacts | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/artifacts | Get Project Data Index Document Artifacts |
ContentManagerApi | get_project_data_index_document_events | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/doc_events | Get Project Data Index Document Events |
ContentManagerApi | get_project_data_index_document_markdown | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/Markdown | Get Project Data Index Document Markdown |
ContentManagerApi | get_project_data_index_document_metadata | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/metadata | Get Project Data Index Document Metadata |
ContentManagerApi | get_project_data_index_documents | GET /project/{proj_key}/data_indices/{index_key}/documents/agent/{agent_name} | Get Project Data Index Documents |
ContentManagerApi | get_project_data_index_grouped_documents | GET /project/{proj_key}/data_indices/{index_key}/documents/agent/{agent_name}/grouped | Get Project Data Index Grouped Documents |
ContentManagerApi | get_project_data_index_json_document | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/JSON | Get Project Data Index Json Document |
ContentManagerApi | get_project_data_index_pdf_document | GET /project/{proj_key}/data_indices/{index_key}/documents/{document_hash}/PDF | Get Project Data Index Pdf Document |
ContentManagerApi | get_project_documents_by_transaction | GET /project/{proj_key}/data_indices/{index_key}/documents/transactions/{transaction_id} | Get Project Documents By Transaction |
ContentManagerApi | get_project_index_upload_jobs | GET /project/{proj_key}/data_indices/{index_key}/documents/upload_jobs | Get Project Index Upload Jobs |
DataIndicesApi | create_project_data_index | POST /project/{proj_key}/data_indices | Create Project Data Index |
DataIndicesApi | create_project_data_index_delete_token | POST /project/{proj_key}/data_indices/{index_key}/delete_token | Create Project Data Index Delete Token |
DataIndicesApi | delete_project_data_index | DELETE /project/{proj_key}/data_indices/{index_key} | Delete Project Data Index |
DataIndicesApi | get_project_data_index | GET /project/{proj_key}/data_indices/{index_key} | Get Project Data Index |
DataIndicesApi | get_project_data_index_conversion_settings | GET /project/{proj_key}/data_indices/{index_key}/conversion_settings | Get Project Data Index Conversion Settings |
DataIndicesApi | get_project_data_indices | GET /project/{proj_key}/data_indices | Get Project Data Indices |
DataIndicesApi | update_project_data_index | PATCH /project/{proj_key}/data_indices/{index_key} | Update Project Data Index |
DataIndicesApi | update_project_data_index_conversion_settings | PATCH /project/{proj_key}/data_indices/{index_key}/conversion_settings | Update Project Data Index Conversion Settings |
DataIndicesUploadApi | ccs_convert_file_project_data_index | POST /project/{proj_key}/data_indices/{index_key}/actions/ccs_convert | Ccs Convert File Project Data Index |
DataIndicesUploadApi | ccs_convert_upload_file_project_data_index | POST /project/{proj_key}/data_indices/{index_key}/actions/ccs_convert_upload | Ccs Convert Upload File Project Data Index |
DataIndicesUploadApi | get_attachment_upload_data | GET /project/{proj_key}/data_indices/{index_key}/documents/{index_item_id}/attachment_url/{filename} | Get Attachment Upload Data |
DataIndicesUploadApi | html_print_convert_upload | POST /project/{proj_key}/data_indices/{index_key}/actions/html_print_convert_upload | Html Print Convert Upload |
DataIndicesUploadApi | load_project_data_index_files_elastic | POST /project/{proj_key}/data_indices/{index_key}/actions/load_elastic | Load Project Data Index Files Elastic |
DataIndicesUploadApi | register_attachment | POST /project/{proj_key}/data_indices/{index_key}/documents/{index_item_id}/attachment | Register Attachment |
DataIndicesUploadApi | upload_project_data_index_file | POST /project/{proj_key}/data_indices/{index_key}/actions/upload | Upload Project Data Index File |
DataIndicesUploadApi | upload_register_project_documents | POST /project/{proj_key}/data_indices/{index_key}/actions/upload_register_documents | Upload Register Project Documents |
KnowledgeGraphsApi | backend_list_project_kgs | GET /backend/project/{proj_key}/bags | Backend List Project Kgs |
KnowledgeGraphsApi | create_project_knowledge_graph | POST /backend/project/{proj_key}/bags | Create Project Knowledge Graph |
KnowledgeGraphsApi | list_public_knowledge_graphs | GET /project/public/bags | List Public Knowledge Graphs |
KnowledgeGraphsApi | update_project_knowledge_graph_metadata | PATCH /backend/project/{proj_key}/bags/{bag_key} | Update Project Knowledge Graph Metadata |
ProjectApi | convert_document | POST /project/{proj_key}/convert | Convert Document |
ProjectApi | delete_project_integration_config_genai | DELETE /project/{proj_key}/integrations/genai | Delete Project Integration Config Genai |
ProjectApi | get_convert_task | GET /project/{proj_key}/convert_tasks/{task_id} | Get Convert Task |
ProjectApi | get_project_default_values | GET /project/{proj_key}/default_values | Get Project Default Values |
ProjectApi | get_project_integration_config_genai | GET /project/{proj_key}/integrations/genai | Get Project Integration Config Genai |
ProjectApi | provision_project_packages | POST /project/{proj_key}/packages | Provision Project Packages |
ProjectApi | update_project_default_values | POST /project/{proj_key}/default_values | Update Project Default Values |
ProjectApi | update_project_integration_config_genai | POST /project/{proj_key}/integrations/genai | Update Project Integration Config Genai |
SemanticApi | ingest | POST /project/{proj_key}/semantic/ingest | Ingest |
SystemApi | get_system_information | GET /system/info | Get System Information |
SystemApi | get_system_modules_configuration | GET /system/modules/configuration | Get System Modules Configuration |
SystemApi | get_system_modules_tasks | GET /system/modules/tasks | Get System Modules Tasks |
SystemApi | list_packages | GET /system/packages | List Packages |
SystemApi | list_system_knowledge_graphs | GET /system/kgs | List System Knowledge Graphs |
SystemApi | system_get_all_dcs_admin | GET /system/admin/get_all_dcs | System Get All Dcs Admin |
SystemApi | system_get_all_kgs_admin | GET /system/admin/get_all_kgs | System Get All Kgs Admin |
SystemFlavoursApi | delete_flavour | DELETE /system/admin/delete_flavour/{flavour_name} | Delete Flavour |
SystemFlavoursApi | get_flavour | GET /system/admin/get_flavour/{flavour_name} | Get Flavour |
SystemFlavoursApi | list_all_flavours | GET /system/admin/list_all_flavours | List All Flavours |
SystemFlavoursApi | list_flavours_by_project | GET /system/admin/get_project_flavours/{proj_key} | List Flavours By Project |
SystemFlavoursApi | list_projects_flavours | GET /system/admin/list_projects_flavours | List Projects Flavours |
SystemFlavoursApi | save_flavour | PUT /system/admin/save_flavour | Save Flavour |
SystemFlavoursApi | save_project_flavours | PUT /system/admin/save_project_flavours | Save Project Flavours |
SystemQuotasApi | get_flavours_default_quotas | GET /system/admin/get_flavours_default_quota | Get Flavours Default Quotas |
SystemQuotasApi | get_project_flavour_total_kgs | GET /system/admin/get_project_flavour_total_kgs/{proj_key}/{flavour_name} | Get Project Flavour Total Kgs |
SystemQuotasApi | get_project_flavours_quota | GET /system/admin/get_project_flavours_quota/{proj_key} | Get Project Flavours Quota |
SystemQuotasApi | get_projects_flavours_quota | GET /system/admin/get_projects_flavours_quota | Get Projects Flavours Quota |
SystemQuotasApi | save_flavours_default_quotas | PUT /system/admin/save_flavours_default_quota | Save Flavours Default Quotas |
SystemQuotasApi | save_project_flavours_quota | PUT /system/admin/save_project_flavours_quota | Save Project Flavours Quota |
SystemSummaryApi | system_get_cps_summary | GET /system/admin/summary | System Get Cps Summary |
SystemSummaryApi | system_get_dc_storage_summary_async | GET /system/admin/dc_storage_summary/{dc_key} | System Get Dc Storage Summary Async |
SystemSummaryApi | system_get_kg_storage_summary_async | GET /system/admin/kg_storage_summary/{kg_key} | System Get Kg Storage Summary Async |
TasksApi | abort_project_task | POST /project/{proj_key}/tasks/{task_id}/actions/abort | Abort Project Task |
TasksApi | get_project_celery_task | GET /project/{proj_key}/celery_tasks/{task_id} | Get Project Celery Task |
TasksApi | get_project_task | GET /project/{proj_key}/tasks/{task_id} | Get Project Task |
TasksApi | list_project_tasks | GET /project/{proj_key}/tasks | List Project Tasks |
UploadApi | create_project_scratch_file | POST /project/{proj_key}/scratch/files/upload/{filename} | Create Project Scratch File |
UploadApi | list_project_scratch_files | GET /project/{proj_key}/scratch/files | List Project Scratch Files |
UploadApi | list_project_scratch_files_paginated | GET /project/{proj_key}/scratch/files_paginated | List Project Scratch Files Paginated |
Documentation For Models¶
- Abstract
- Acquisition
- AddAnnotations
- AddRawPages
- Affiliation
- Affiliations
- AgentName
- Aggs
- Alias
- Aliases
- AlternateNames
- ApiServerFastapiServerPublicModelsDataIndicesUploadModelsHttpSource
- ApiServerFastapiServerPublicModelsDataIndicesUploadModelsIdentifier
- ApiServerFastapiServerPublicModelsProjectModelsHttpSource
- AssembleMode
- AssembleSettings
- AttachmentUploadData
- AttachmentUploadRequestBody
- Author
- Authors
- Backend
- BackendSettings
- BagFlavourFullData
- BeginDate
- CCSProject
- CPSPackage
- CPSSummary
- CitationCount
- CitationCountDate
- Code
- CollectionDocumentInfoStr
- CollectionMetadataSettings
- Comment
- CompletedAt
- Config
- ConversionSettings
- ConvertDocumentRequest
- ConvertDocumentRequestFileSource
- ConvertDocumentRequestHttpSource
- ConvertDocumentRequestImageUrls
- ConvertDocumentRequestSettings
- ConvertDocumentsRequestBody
- ConvertDocumentsRequestBodyTargetSettings
- ConvertDocumentsSources
- ConvertDocumentsSourcesS3Source
- ConvertUploadDocumentsRequestBody
- ConvertUploadDocumentsRequestBodyMeta
- CpsTask
- Created
- Data
- DataFlow
- DataIndexUploadFileSource
- DcKey
- DecodeSecrets
- DefaultValues
- DefaultValuesDataflow
- Deployment
- Description
- DescriptionLicense
- DirectModelConfig
- DisplayName
- DoclingCoreTypesBaseIdentifier
- DocumentArtifacts
- DocumentArtifactsDocumentMetaJson
- DocumentArtifactsItem
- DocumentArtifactsPageItem
- DocumentDescription
- DocumentDescriptionAcquisition
- DocumentDescriptionAdvanced
- DocumentDescriptionLicense
- DocumentHashes
- DocumentMeta
- DocumentMetaDescription
- DocumentStatistics
- Domain
- ElasticIndexPropertyObject
- ElasticIndexPropertyPrimitive
- ElasticIndexSearchQueryOptions
- ElasticIndexSource
- ElasticInstanceDataIndex
- ElasticMetadata
- Enabled
- EndDate
- ErrorReason
- FileSource
- FileUri
- FileUrl
- Filename
- Flavour
- FlavoursDefaultQuota
- FlavoursQuota
- GenAIAWSBedrock
- GenAIAWSBedrockConfig
- GenAIAWSBedrockProjParams
- GenAIBAM
- GenAIBAMConfig
- GenAICPD
- GenAICPDConfig
- GenAIHFInferenceApi
- GenAIHFInferenceApiConfig
- GenAIOpenai
- GenAIOpenaiConfig
- GenAIParams
- GenAIPartialParams
- GenAIWatsonx
- GenAIWatsonxConfig
- GenaiCpdApiKey
- GenaiCpdPassword
- GroupedProjectDocuments
- HTTPValidationError
- HeadUrl
- Headers
- HttpSource
- Id
- Identifiers
- Identifiers1
- IgnoreAbove
- ImageUrlsInfo
- Issue
- JsonUploadRequestBody
- KeyPrefix
- Keywords
- KgKey
- Languages
- License
- Link
- ListProjectFlavours
- Log
- MergeMode
- ModelDate
- ModelFrom
- ModelId
- ModelPipelineSettings
- ModelPipelineSettingsClustersInner
- ModulesConfig
- Name
- NumberPages
- OCROptions
- ObjectKeys
- OcrSettings
- Package
- Page
- PageLabels
- Pages
- Params
- PartialDirectConversionParameters
- PartialDirectConversionParametersAssemble
- PartialDirectConversionParametersMetadata
- PartialDirectConversionParametersModelPipeline
- PartialDirectConversionParametersOcr
- ProjKey
- ProjectAgent
- ProjectAgents
- ProjectDataIndexConversionSettingsInput
- ProjectDataIndexConversionSettingsOutput
- ProjectDataIndexNonView
- ProjectDataIndexSource
- ProjectDataIndexView
- ProjectDataIndexWithStatus
- ProjectDataIndexWithStatusMetadata
- ProjectDocument
- ProjectDocumentURL
- ProjectDocuments
- ProjectFlavourTotalKgs
- ProjectFlavoursQuota
- ProjectPackageInstalationManifest
- ProjectScratchFiles
- ProjectScratchFilesPaginated
- ProjectSourceDataIndex
- ProjectsFlavours
- PromptTemplate
- Properties
- Provenance
- Publication
- Publication1
- PublicationDate
- Publishers
- Query
- RecordProperties
- RefUri
- ReferenceCount
- ReferenceToModel
- References
- RelatedTasks
- ResponseDocumentArtifacts
- ResponseGetProjectDataIndexConversionSettings
- ResponseGetProjectIntegrationConfigGenai
- ResponseGroupedDocuments
- ResponseUpdateProjectDataIndexConversionSettings
- ResponseUploadJobs
- S3Coordinates
- S3DocumentSource
- SchemaKey
- ScratchIds
- SearchString
- SemanticIngestReqParams
- SemanticIngestRequest
- SemanticIngestSourcePrivateDataCollection
- SemanticIngestSourcePrivateDataDocument
- SemanticIngestSourcePublicDataDocument
- SemanticIngestSourceUrl
- Size
- Size1
- Sort
- Source
- Source1
- Source2
- Source3
- Source4
- StartCount
- StartedAt
- Status
- StatusFilter
- Storage
- StorageSummaryTask
- Subjects
- SystemInfo
- TableFormerMode
- TableStructureOptions
- TargetConversionParameters
- Task
- TaskContext
- TaskResult
- TaskType
- TemporaryUploadFileResult
- TemporaryUrl
- TemporaryUrlFields
- Term
- Text
- Timeout
- Title
- TokenResponse
- TruncatePages
- Type
- Type1
- UploadDate
- UploadElasticRequestBody
- UploadJob
- UploadToElastic
- Url
- UrlRefs
- Urls
- ValidationError
- ValidationErrorLocInner
- Version
- Version1
- ViewOf
- ViewOf1
- Volume
- Wait
- Wait1
- WithOperations
- WithoutOperations
Documentation For Authorization¶
Authentication schemes defined for the API:
Bearer¶
- Type: API key
- API key parameter name: Authorization
- Location: HTTP header