carbon.auth.get_access_tokencarbon.auth.get_white_labelingcarbon.crm.get_accountcarbon.crm.get_accountscarbon.crm.get_contactcarbon.crm.get_contactscarbon.crm.get_leadcarbon.crm.get_leadscarbon.crm.get_opportunitiescarbon.crm.get_opportunitycarbon.data_sources.add_tagscarbon.data_sources.querycarbon.data_sources.query_user_data_sourcescarbon.data_sources.remove_tagscarbon.data_sources.revoke_access_tokencarbon.embeddings.get_documentscarbon.embeddings.get_embeddings_and_chunkscarbon.embeddings.listcarbon.embeddings.upload_chunks_and_embeddingscarbon.files.create_user_file_tagscarbon.files.delete_file_tagscarbon.files.delete_manycarbon.files.delete_v2carbon.files.get_parsed_filecarbon.files.get_raw_filecarbon.files.modify_cold_storage_parameterscarbon.files.move_to_hot_storagecarbon.files.query_user_filescarbon.files.query_user_files_deprecatedcarbon.files.resynccarbon.files.uploadcarbon.files.upload_from_urlcarbon.files.upload_textcarbon.github.get_issuecarbon.github.get_issuescarbon.github.get_prcarbon.github.get_pr_commentscarbon.github.get_pr_commitscarbon.github.get_pr_filescarbon.github.get_pull_requestscarbon.integrations.cancelcarbon.integrations.connect_data_sourcecarbon.integrations.connect_document360carbon.integrations.connect_freshdeskcarbon.integrations.connect_gitbookcarbon.integrations.connect_gurucarbon.integrations.create_aws_iam_usercarbon.integrations.get_oauth_urlcarbon.integrations.list_confluence_pagescarbon.integrations.list_conversationscarbon.integrations.list_data_source_itemscarbon.integrations.list_folderscarbon.integrations.list_gitbook_spacescarbon.integrations.list_labelscarbon.integrations.list_outlook_categoriescarbon.integrations.list_reposcarbon.integrations.list_sharepoint_sitescarbon.integrations.sync_azure_blob_filescarbon.integrations.sync_azure_blob_storagecarbon.integrations.sync_confluencecarbon.integrations.sync_data_source_itemscarbon.integrations.sync_filescarbon.integrations.sync_git_hubcarbon.integrations.sync_gitbookcarbon.integrations.sync_gmailcarbon.integrations.sync_outlookcarbon.integrations.sync_reposcarbon.integrations.sync_rss_feedcarbon.integrations.sync_s3_filescarbon.integrations.sync_slackcarbon.organizations.getcarbon.organizations.updatecarbon.organizations.update_statscarbon.users.deletecarbon.users.getcarbon.users.listcarbon.users.toggle_user_featurescarbon.users.update_userscarbon.users.who_am_icarbon.utilities.fetch_urlscarbon.utilities.fetch_webpagecarbon.utilities.fetch_youtube_transcriptscarbon.utilities.process_sitemapcarbon.utilities.scrape_sitemapcarbon.utilities.scrape_webcarbon.utilities.search_urlscarbon.utilities.user_webpagescarbon.webhooks.add_urlcarbon.webhooks.delete_urlcarbon.webhooks.urlscarbon.white_label.createcarbon.white_label.deletecarbon.white_label.listcarbon.white_label.updateAdd to Gemfile:
gem 'carbon_ruby_sdk', '~> 0.2.53'
require 'carbon_ruby_sdk'
# 1) Get an access token for a customer
configuration = Carbon::Configuration.new
configuration.api_key = "YOUR_API_KEY"
configuration.customer_id = "YOUR_CUSTOMER_ID"
carbon = Carbon::Client.new(configuration)
token = carbon.auth.get_access_token
# 2) Use the access token to authenticate moving forward
configuration = Carbon::Configuration.new
configuration.access_token = token.access_token
carbon = Carbon::Client.new(configuration)
# use SDK as usual
white_labeling = carbon.auth.get_white_labeling
To access the raw HTTP response, suffix any method with _with_http_info.
result = carbon.auth.get_access_token_with_http_info
p result.data # [TokenResponse] Deserialized data
p.result.status_code # [Integer] HTTP status code
p.result.headers # [Hash] HTTP headers
p.result.response # [Faraday::Response] Raw HTTP response
carbon.auth.get_access_tokenGet Access Token
result = carbon.auth.get_access_token
p result
/auth/v1/access_token GET
carbon.auth.get_white_labelingReturns whether or not the organization is white labeled and which integrations are white labeled
:param current_user: the current user :param db: the database session :return: a WhiteLabelingResponse
result = carbon.auth.get_white_labeling
p result
/auth/v1/white_labeling GET
carbon.crm.get_accountGet Account
result = carbon.crm.get_account(
id: "id_example",
data_source_id: 1,
include_remote_data: false,
includes: [
"string_example"
],
)
p result
StringIntegerBooleanBaseIncludes>/integrations/data/crm/accounts/{id} GET
carbon.crm.get_accountsGet Accounts
result = carbon.crm.get_accounts(
data_source_id: 1,
include_remote_data: false,
next_cursor: "string_example",
page_size: 1,
order_dir: "asc",
includes: [],
filters: {
},
order_by: "created_at",
)
p result
IntegerBooleanStringIntegerOrderDirV2NullableBaseIncludes>AccountFiltersAccountsOrderByNullable/integrations/data/crm/accounts POST
carbon.crm.get_contactGet Contact
result = carbon.crm.get_contact(
id: "id_example",
data_source_id: 1,
include_remote_data: false,
includes: [
"string_example"
],
)
p result
StringIntegerBooleanBaseIncludes>/integrations/data/crm/contacts/{id} GET
carbon.crm.get_contactsGet Contacts
result = carbon.crm.get_contacts(
data_source_id: 1,
include_remote_data: false,
next_cursor: "string_example",
page_size: 1,
order_dir: "asc",
includes: [],
filters: {
},
order_by: "created_at",
)
p result
IntegerBooleanStringIntegerOrderDirV2NullableBaseIncludes>ContactFiltersContactsOrderByNullable/integrations/data/crm/contacts POST
carbon.crm.get_leadGet Lead
result = carbon.crm.get_lead(
id: "id_example",
data_source_id: 1,
include_remote_data: false,
includes: [
"string_example"
],
)
p result
StringIntegerBooleanBaseIncludes>/integrations/data/crm/leads/{id} GET
carbon.crm.get_leadsGet Leads
result = carbon.crm.get_leads(
data_source_id: 1,
include_remote_data: false,
next_cursor: "string_example",
page_size: 1,
order_dir: "asc",
includes: [],
filters: {
},
order_by: "created_at",
)
p result
IntegerBooleanStringIntegerOrderDirV2NullableBaseIncludes>LeadFiltersLeadsOrderByNullable/integrations/data/crm/leads POST
carbon.crm.get_opportunitiesGet Opportunities
result = carbon.crm.get_opportunities(
data_source_id: 1,
include_remote_data: false,
next_cursor: "string_example",
page_size: 1,
order_dir: "asc",
includes: [],
filters: {
"status" => "WON",
},
order_by: "created_at",
)
p result
IntegerBooleanStringIntegerOrderDirV2NullableBaseIncludes>OpportunityFiltersOpportunitiesOrderByNullable/integrations/data/crm/opportunities POST
carbon.crm.get_opportunityGet Opportunity
result = carbon.crm.get_opportunity(
id: "id_example",
data_source_id: 1,
include_remote_data: false,
includes: [
"string_example"
],
)
p result
StringIntegerBooleanBaseIncludes>/integrations/data/crm/opportunities/{id} GET
carbon.data_sources.add_tagsAdd Data Source Tags
result = carbon.data_sources.add_tags(
tags: {},
data_source_id: 1,
)
p result
ObjectInteger/data_sources/tags/add POST
carbon.data_sources.queryData Sources
result = carbon.data_sources.query(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"source" => "GOOGLE_CLOUD_STORAGE",
},
)
p result
PaginationOrganizationUserDataSourceOrderByColumnsOrderDirOrganizationUserDataSourceFiltersOrganizationUserDataSourceResponse
/data_sources POST
carbon.data_sources.query_user_data_sourcesUser Data Sources
result = carbon.data_sources.query_user_data_sources(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"source" => "GOOGLE_CLOUD_STORAGE",
},
)
p result
PaginationOrganizationUserDataSourceOrderByColumnsOrderDirOrganizationUserDataSourceFiltersOrganizationUserDataSourceResponse
/user_data_sources POST
carbon.data_sources.remove_tagsRemove Data Source Tags
result = carbon.data_sources.remove_tags(
data_source_id: 1,
tags_to_remove: [],
remove_all_tags: false,
)
p result
IntegerString>Boolean/data_sources/tags/remove POST
carbon.data_sources.revoke_access_tokenRevoke Access Token
result = carbon.data_sources.revoke_access_token(
data_source_id: 1,
)
p result
Integer/revoke_access_token POST
carbon.embeddings.get_documentsFor pre-filtering documents, using tags_v2 is preferred to using tags (which is now deprecated). If both tags_v2
and tags are specified, tags is ignored. tags_v2 enables
building complex filters through the use of "AND", "OR", and negation logic. Take the below input as an example:
{
"OR": [
{
"key": "subject",
"value": "holy-bible",
"negate": false
},
{
"key": "person-of-interest",
"value": "jesus christ",
"negate": false
},
{
"key": "genre",
"value": "religion",
"negate": true
}
{
"AND": [
{
"key": "subject",
"value": "tao-te-ching",
"negate": false
},
{
"key": "author",
"value": "lao-tzu",
"negate": false
}
]
}
]
}
In this case, files will be filtered such that:
Note that the top level of the query must be either an "OR" or "AND" array. Currently, nesting is limited to 3. For tag blocks (those with "key", "value", and "negate" keys), the following typing rules apply:
stringany or list[any]true or false. If present and true, then the filter block is negated in
the resulting query. It is false by default.When querying embeddings, you can optionally specify the media_type parameter in your request. By default (if
not set), it is equal to "TEXT". This means that the query will be performed over files that have
been parsed as text (for now, this covers all files except image files). If it is equal to "IMAGE",
the query will be performed over image files (for now, .jpg and .png files). You can think of this
field as an additional filter on top of any filters set in file_ids and
When hybrid_search is set to true, a combination of keyword search and semantic search are used to rank
and select candidate embeddings during information retrieval. By default, these search methods are weighted
equally during the ranking process. To adjust the weight (or "importance") of each search method, you can use
the hybrid_search_tuning_parameters property. The description for the different tuning parameters are:
weight_a: weight to assign to semantic searchweight_b: weight to assign to keyword searchYou must ensure that sum(weight_a, weight_b,..., weight_n) for all n weights is equal to 1. The equality
has an error tolerance of 0.001 to account for possible floating point issues.
In order to use hybrid search for a customer across a set of documents, two flags need to be enabled:
/modify_user_configuration endpoint to to enable sparse_vectors for the customer. The payload
body for this request is below:{
"configuration_key_name": "sparse_vectors",
"value": {
"enabled": true
}
}
/uploadfile endpoint, this can be done by setting the following query parameter: generate_sparse_vectors=trueCarbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's
multimodal model; for text, we support OpenAI's text-embedding-ada-002 and Cohere's embed-multilingual-v3.0.
The model can be specified via the embedding_model parameter (in the POST body for /embeddings, and a query
parameter in /uploadfile). If no model is supplied, the text-embedding-ada-002 is used by default. When performing
embedding queries, embeddings from files that used the specified model will be considered in the query.
For example, if files A and B have embeddings generated with OPENAI, and files C and D have embeddings generated with
COHERE_MULTILINGUAL_V3, then by default, queries will only consider files A and B. If COHERE_MULTILINGUAL_V3 is
specified as the embedding_model in /embeddings, then only files C and D will be considered. Make sure that
the set of all files you want considered for a query have embeddings generated via the same model. For now, do not
set VERTEX_MULTIMODAL as an embedding_model. This model is used automatically by Carbon when it detects an image file.
result = carbon.embeddings.get_documents(
query: "a",
k: 1,
tags: {
"key": "string_example",
},
query_vector: [
3.14
],
file_ids: [
1
],
parent_file_ids: [
1
],
include_all_children: false,
tags_v2: {
},
include_tags: true,
include_vectors: true,
include_raw_file: true,
hybrid_search: true,
hybrid_search_tuning_parameters: {
"weight_a" => 0.5,
"weight_b" => 0.5,
},
media_type: "TEXT",
embedding_model: "OPENAI",
include_file_level_metadata: false,
high_accuracy: false,
rerank: {
"model" => "model_example",
},
file_types_at_source: [
"string_example"
],
exclude_cold_storage_files: false,
)
p result
StringQuery for which to get related chunks and embeddings.
IntegerNumber of related chunks to return.
Tags1>A set of tags to limit the search to. Deprecated and may be removed in the future.
Float>Optional query vector for which to get related chunks and embeddings. It must
have been generated by the same model used to generate the embeddings across
which the search is being conducted. Cannot provide both query and
query_vector.
Integer>Optional list of file IDs to limit the search to
Integer>Optional list of parent file IDs to limit the search to. A parent file describes a file to which another file belongs (e.g. a folder)
BooleanFlag to control whether or not to include all children of filtered files in the embedding search.
ObjectA set of tags to limit the search to. Use this instead of tags, which is
deprecated.
BooleanFlag to control whether or not to include tags for each chunk in the response.
BooleanFlag to control whether or not to include embedding vectors in the response.
BooleanFlag to control whether or not to include a signed URL to the raw file containing each chunk in the response.
BooleanFlag to control whether or not to perform hybrid search.
HybridSearchTuningParamsNullableFileContentTypesNullableEmbeddingGeneratorsNullableBooleanFlag to control whether or not to include file-level metadata in the response.
This metadata will be included in the content_metadata field of each document
along with chunk/embedding level metadata.
BooleanFlag to control whether or not to perform a high accuracy embedding search. By default, this is set to false. If true, the search may return more accurate results, but may take longer to complete.
RerankParamsNullableAutoSyncedSourceTypesPropertyInner>Filter files based on their type at the source (for example help center tickets and articles)
BooleanFlag to control whether or not to exclude files that are not in hot storage. If set to False, then an error will be returned if any filtered files are in cold storage.
/embeddings POST
carbon.embeddings.get_embeddings_and_chunksRetrieve Embeddings And Content
result = carbon.embeddings.get_embeddings_and_chunks(
filters: {
"user_file_id" => 1,
"embedding_model" => "OPENAI",
},
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
include_vectors: false,
)
p result
EmbeddingsAndChunksFiltersPaginationEmbeddingsAndChunksOrderByColumnsOrderDirBoolean/text_chunks POST
carbon.embeddings.listRetrieve Embeddings And Content V2
result = carbon.embeddings.list(
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
include_vectors: false,
)
p result
OrganizationUserFilesToSyncFiltersPaginationOrganizationUserFilesToSyncOrderByTypesOrderDirBoolean/list_chunks_and_embeddings POST
carbon.embeddings.upload_chunks_and_embeddingsUpload Chunks And Embeddings
result = carbon.embeddings.upload_chunks_and_embeddings(
embedding_model: "OPENAI",
chunks_and_embeddings: [
{
"file_id" => 1,
"chunks_and_embeddings" => [
{
"chunk_number" => 1,
"chunk" => "chunk_example",
}
],
}
],
overwrite_existing: false,
chunks_only: false,
custom_credentials: {
"key": {},
},
)
p result
EmbeddingGeneratorsSingleChunksAndEmbeddingsUploadInput>BooleanBooleanHash<String, Object>/upload_chunks_and_embeddings POST
carbon.files.create_user_file_tagsA tag is a key-value pair that can be added to a file. This pair can then be used for searches (e.g. embedding searches) in order to narrow down the scope of the search. A file can have any number of tags. The following are reserved keys that cannot be used:
Carbon currently supports two data types for tag values - string and list<string>.
Keys can only be string. If values other than string and list<string> are used,
they're automatically converted to strings (e.g. 4 will become "4").
result = carbon.files.create_user_file_tags(
tags: {
"key": "string_example",
},
organization_user_file_id: 1,
)
p result
Tags1>Integer/create_user_file_tags POST
carbon.files.delete_file_tagsDelete File Tags
result = carbon.files.delete_file_tags(
tags: [
"string_example"
],
organization_user_file_id: 1,
)
p result
String>Integer/delete_user_file_tags POST
carbon.files.delete_manyDelete Files Endpoint
result = carbon.files.delete_many(
file_ids: [
1
],
sync_statuses: [
"string_example"
],
delete_non_synced_only: false,
send_webhook: false,
delete_child_files: false,
)
p result
Integer>ExternalFileSyncStatuses>BooleanBooleanBoolean/delete_files POST
carbon.files.delete_v2Delete Files V2 Endpoint
result = carbon.files.delete_v2(
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
send_webhook: false,
preserve_file_record: false,
)
p result
OrganizationUserFilesToSyncFiltersBooleanBooleanWhether or not to delete all data related to the file from the database, BUT to
preserve the file metadata, allowing for resyncs. By default
preserve_file_record is false, which means that all data related to the file
as well as its metadata will be deleted. Note that even if
preserve_file_record is true, raw files uploaded via the uploadfile endpoint
still cannot be resynced.
/delete_files_v2 POST
carbon.files.get_parsed_fileThis route is deprecated. Use /user_files_v2 instead.
result = carbon.files.get_parsed_file(
file_id: 1,
)
p result
Integer/parsed_file/{file_id} GET
carbon.files.get_raw_fileThis route is deprecated. Use /user_files_v2 instead.
result = carbon.files.get_raw_file(
file_id: 1,
)
p result
Integer/raw_file/{file_id} GET
carbon.files.modify_cold_storage_parametersModify Cold Storage Parameters
result = carbon.files.modify_cold_storage_parameters(
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
enable_cold_storage: true,
hot_storage_time_to_live: 1,
)
p result
OrganizationUserFilesToSyncFiltersBooleanInteger/modify_cold_storage_parameters POST
carbon.files.move_to_hot_storageMove To Hot Storage
result = carbon.files.move_to_hot_storage(
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
)
p result
OrganizationUserFilesToSyncFilters/move_to_hot_storage POST
carbon.files.query_user_filesFor pre-filtering documents, using tags_v2 is preferred to using tags (which is now deprecated). If both tags_v2
and tags are specified, tags is ignored. tags_v2 enables
building complex filters through the use of "AND", "OR", and negation logic. Take the below input as an example:
{
"OR": [
{
"key": "subject",
"value": "holy-bible",
"negate": false
},
{
"key": "person-of-interest",
"value": "jesus christ",
"negate": false
},
{
"key": "genre",
"value": "religion",
"negate": true
}
{
"AND": [
{
"key": "subject",
"value": "tao-te-ching",
"negate": false
},
{
"key": "author",
"value": "lao-tzu",
"negate": false
}
]
}
]
}
In this case, files will be filtered such that:
Note that the top level of the query must be either an "OR" or "AND" array. Currently, nesting is limited to 3. For tag blocks (those with "key", "value", and "negate" keys), the following typing rules apply:
stringany or list[any]true or false. If present and true, then the filter block is negated in
the resulting query. It is false by default.result = carbon.files.query_user_files(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
include_raw_file: true,
include_parsed_text_file: true,
include_additional_files: true,
presigned_url_expiry_time_seconds: 3600,
)
p result
PaginationOrganizationUserFilesToSyncOrderByTypesOrderDirOrganizationUserFilesToSyncFiltersBooleanIf true, the query will return presigned URLs for the raw file. Only relevant for the /user_files_v2 endpoint.
BooleanIf true, the query will return presigned URLs for the parsed text file. Only relevant for the /user_files_v2 endpoint.
BooleanIf true, the query will return presigned URLs for additional files. Only relevant for the /user_files_v2 endpoint.
IntegerThe expiry time for the presigned URLs. Only relevant for the /user_files_v2 endpoint.
/user_files_v2 POST
carbon.files.query_user_files_deprecatedThis route is deprecated. Use /user_files_v2 instead.
result = carbon.files.query_user_files_deprecated(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"include_all_children" => false,
"non_synced_only" => false,
},
include_raw_file: true,
include_parsed_text_file: true,
include_additional_files: true,
presigned_url_expiry_time_seconds: 3600,
)
p result
PaginationOrganizationUserFilesToSyncOrderByTypesOrderDirOrganizationUserFilesToSyncFiltersBooleanIf true, the query will return presigned URLs for the raw file. Only relevant for the /user_files_v2 endpoint.
BooleanIf true, the query will return presigned URLs for the parsed text file. Only relevant for the /user_files_v2 endpoint.
BooleanIf true, the query will return presigned URLs for additional files. Only relevant for the /user_files_v2 endpoint.
IntegerThe expiry time for the presigned URLs. Only relevant for the /user_files_v2 endpoint.
/user_files POST
carbon.files.resyncResync File
result = carbon.files.resync(
file_id: 1,
chunk_size: 1,
chunk_overlap: 1,
force_embedding_generation: false,
skip_file_processing: false,
)
p result
IntegerIntegerIntegerBooleanBoolean/resync_file POST
carbon.files.uploadThis endpoint is used to directly upload local files to Carbon. The POST request should be a multipart form request.
Note that the set_page_as_boundary query parameter is applicable only to PDFs for now. When this value is set,
PDF chunks are at most one page long. Additional information can be retrieved for each chunk, however, namely the coordinates
of the bounding box around the chunk (this can be used for things like text highlighting). Following is a description
of all possible query parameters:
chunk_size: the chunk size (in tokens) applied when splitting the documentchunk_overlap: the chunk overlap (in tokens) applied when splitting the documentskip_embedding_generation: whether or not to skip the generation of chunks and embeddingsset_page_as_boundary: described aboveembedding_model: the model used to generate embeddings for the document chunksuse_ocr: whether or not to use OCR as a preprocessing step prior to generating chunks. Valid for PDFs, JPEGs, and PNGsgenerate_sparse_vectors: whether or not to generate sparse vectors for the file. Required for hybrid search.prepend_filename_to_chunks: whether or not to prepend the filename to the chunk textCarbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's
multimodal model; for text, we support OpenAI's text-embedding-ada-002 and Cohere's embed-multilingual-v3.0.
The model can be specified via the embedding_model parameter (in the POST body for /embeddings, and a query
parameter in /uploadfile). If no model is supplied, the text-embedding-ada-002 is used by default. When performing
embedding queries, embeddings from files that used the specified model will be considered in the query.
For example, if files A and B have embeddings generated with OPENAI, and files C and D have embeddings generated with
COHERE_MULTILINGUAL_V3, then by default, queries will only consider files A and B. If COHERE_MULTILINGUAL_V3 is
specified as the embedding_model in /embeddings, then only files C and D will be considered. Make sure that
the set of all files you want considered for a query have embeddings generated via the same model. For now, do not
set VERTEX_MULTIMODAL as an embedding_model. This model is used automatically by Carbon when it detects an image file.
result = carbon.files.upload(
file: File.open("path/to/file", "rb"),
chunk_size: 1,
chunk_overlap: 1,
skip_embedding_generation: false,
set_page_as_boundary: false,
embedding_model: "string_example",
use_ocr: false,
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
parse_pdf_tables_with_ocr: false,
detect_audio_language: false,
transcription_service: "assemblyai",
include_speaker_labels: false,
media_type: "TEXT",
split_rows: false,
enable_cold_storage: false,
hot_storage_time_to_live: 1,
generate_chunks_only: false,
store_file_only: false,
)
p result
FileIntegerChunk size in tiktoken tokens to be used when processing file.
IntegerChunk overlap in tiktoken tokens to be used when processing file.
BooleanFlag to control whether or not embeddings should be generated and stored when processing file.
BooleanFlag to control whether or not to set the a page's worth of content as the maximum amount of content that can appear in a chunk. Only valid for PDFs. See description route description for more information.
EmbeddingModelEmbedding model that will be used to embed file chunks.
BooleanWhether or not to use OCR when processing files. Valid for PDFs, JPEGs, and PNGs. Useful for documents with tables, images, and/or scanned text.
BooleanWhether or not to generate sparse vectors for the file. This is required for the file to be a candidate for hybrid search.
BooleanWhether or not to prepend the file's name to chunks.
IntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanWhether to use rich table parsing when use_ocr is enabled.
BooleanWhether to automatically detect the language of the uploaded audio file.
TranscriptionServiceNullableThe transcription service to use for audio files. If no service is specified, 'deepgram' will be used.
BooleanDetect multiple speakers and label segments of speech by speaker for audio files.
FileContentTypesNullableThe media type of the file. If not provided, it will be inferred from the file extension.
BooleanWhether to split tabular rows into chunks. Currently only valid for CSV, TSV, and XLSX files.
BooleanEnable cold storage for the file. If set to true, the file will be moved to cold storage after a certain period of inactivity. Default is false.
IntegerTime in days after which the file will be moved to cold storage. Must be one of [1, 3, 7, 14, 30].
BooleanIf this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
BooleanIf this flag is enabled, the file will be stored with Carbon, but no processing will be done.
/uploadfile POST
carbon.files.upload_from_urlCreate Upload File From Url
result = carbon.files.upload_from_url(
url: "string_example",
file_name: "string_example",
chunk_size: 1,
chunk_overlap: 1,
skip_embedding_generation: false,
set_page_as_boundary: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
use_textract: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
parse_pdf_tables_with_ocr: false,
detect_audio_language: false,
transcription_service: "assemblyai",
include_speaker_labels: false,
media_type: "TEXT",
split_rows: false,
cold_storage_params: {
"enable_cold_storage" => false,
},
generate_chunks_only: false,
store_file_only: false,
)
p result
StringStringIntegerIntegerBooleanBooleanEmbeddingGeneratorsBooleanBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanBooleanTranscriptionServiceNullableBooleanFileContentTypesNullableBooleanColdStoragePropsBooleanIf this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
BooleanIf this flag is enabled, the file will be stored with Carbon, but no processing will be done.
/upload_file_from_url POST
carbon.files.upload_textCarbon supports multiple models for use in generating embeddings for files. For images, we support Vertex AI's
multimodal model; for text, we support OpenAI's text-embedding-ada-002 and Cohere's embed-multilingual-v3.0.
The model can be specified via the embedding_model parameter (in the POST body for /embeddings, and a query
parameter in /uploadfile). If no model is supplied, the text-embedding-ada-002 is used by default. When performing
embedding queries, embeddings from files that used the specified model will be considered in the query.
For example, if files A and B have embeddings generated with OPENAI, and files C and D have embeddings generated with
COHERE_MULTILINGUAL_V3, then by default, queries will only consider files A and B. If COHERE_MULTILINGUAL_V3 is
specified as the embedding_model in /embeddings, then only files C and D will be considered. Make sure that
the set of all files you want considered for a query have embeddings generated via the same model. For now, do not
set VERTEX_MULTIMODAL as an embedding_model. This model is used automatically by Carbon when it detects an image file.
result = carbon.files.upload_text(
contents: "aaaaa",
name: "string_example",
chunk_size: 1,
chunk_overlap: 1,
skip_embedding_generation: false,
overwrite_file_id: 1,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
cold_storage_params: {
"enable_cold_storage" => false,
},
generate_chunks_only: false,
store_file_only: false,
)
p result
StringStringIntegerIntegerBooleanIntegerEmbeddingGeneratorsNullableBooleanColdStoragePropsBooleanIf this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
BooleanIf this flag is enabled, the file will be stored with Carbon, but no processing will be done.
/upload_text POST
carbon.github.get_issueIssue
result = carbon.github.get_issue(
issue_number: 1,
include_remote_data: false,
data_source_id: 1,
repository: "string_example",
)
p result
IntegerBooleanIntegerString/integrations/data/github/issues/{issue_number} GET
carbon.github.get_issuesIssues
result = carbon.github.get_issues(
data_source_id: 1,
repository: "string_example",
include_remote_data: false,
page: 1,
page_size: 30,
next_cursor: "string_example",
filters: {
"state" => "closed",
},
order_by: "created",
order_dir: "asc",
)
p result
IntegerStringFull name of the repository, denoted as {owner}/{repo}
BooleanIntegerIntegerStringIssuesFilterIssuesOrderByOrderDirV2Nullable/integrations/data/github/issues POST
carbon.github.get_prGet Pr
result = carbon.github.get_pr(
pull_number: 1,
include_remote_data: false,
data_source_id: 1,
repository: "string_example",
)
p result
IntegerBooleanIntegerString/integrations/data/github/pull_requests/{pull_number} GET
carbon.github.get_pr_commentsPr Comments
result = carbon.github.get_pr_comments(
data_source_id: 1,
repository: "string_example",
pull_number: 1,
include_remote_data: false,
page: 1,
page_size: 30,
next_cursor: "string_example",
order_by: "created",
order_dir: "asc",
)
p result
IntegerStringFull name of the repository, denoted as {owner}/{repo}
IntegerBooleanIntegerIntegerStringCommentsOrderByOrderDirV2Nullable/integrations/data/github/pull_requests/comments POST
carbon.github.get_pr_commitsPr Commits
result = carbon.github.get_pr_commits(
data_source_id: 1,
repository: "string_example",
pull_number: 1,
include_remote_data: false,
page: 1,
page_size: 30,
next_cursor: "string_example",
)
p result
IntegerStringFull name of the repository, denoted as {owner}/{repo}
IntegerBooleanIntegerIntegerString/integrations/data/github/pull_requests/commits POST
carbon.github.get_pr_filesPr Files
result = carbon.github.get_pr_files(
data_source_id: 1,
repository: "string_example",
pull_number: 1,
include_remote_data: false,
page: 1,
page_size: 30,
next_cursor: "string_example",
)
p result
IntegerStringFull name of the repository, denoted as {owner}/{repo}
IntegerBooleanIntegerIntegerString/integrations/data/github/pull_requests/files POST
carbon.github.get_pull_requestsGet Prs
result = carbon.github.get_pull_requests(
data_source_id: 1,
repository: "string_example",
include_remote_data: false,
page: 1,
page_size: 30,
next_cursor: "string_example",
filters: {
"state" => "closed",
},
order_by: "created",
order_dir: "asc",
)
p result
IntegerStringFull name of the repository, denoted as {owner}/{repo}
BooleanIntegerIntegerStringPullRequestFiltersPROrderByOrderDirV2Nullable/integrations/data/github/pull_requests POST
carbon.integrations.cancelCancel Data Source Items Sync
result = carbon.integrations.cancel(
data_source_id: 1,
)
p result
Integer/integrations/items/sync/cancel POST
carbon.integrations.connect_data_sourceConnect Data Source
result = carbon.integrations.connect_data_source(
authentication: {
"source" => "GOOGLE_DRIVE",
"access_token" => "access_token_example",
},
sync_options: {
"chunk_size" => 1500,
"chunk_overlap" => 20,
"skip_embedding_generation" => false,
"embedding_model" => "OPENAI",
"generate_sparse_vectors" => false,
"prepend_filename_to_chunks" => false,
"sync_files_on_connection" => true,
"set_page_as_boundary" => false,
"enable_file_picker" => true,
"sync_source_items" => true,
"incremental_sync" => false,
},
)
p result
AuthenticationPropertySyncOptions/integrations/connect POST
carbon.integrations.connect_document360You will need an access token to connect your Document360 account. To obtain an access token, follow the steps highlighted here https://apidocs.document360.com/apidocs/api-token.
result = carbon.integrations.connect_document360(
account_email: "string_example",
access_token: "string_example",
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
sync_files_on_connection: true,
request_id: "string_example",
sync_source_items: true,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
data_source_tags: {},
)
p result
StringThis email will be used to identify your carbon data source. It should have access to the Document360 account you wish to connect.
StringObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanBooleanStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
FileSyncConfigNullableObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/document360 POST
carbon.integrations.connect_freshdeskRefer this article to obtain an API key https://support.freshdesk.com/en/support/solutions/articles/215517. Make sure that your API key has the permission to read solutions from your account and you are on a paid plan. Once you have an API key, you can make a request to this endpoint along with your freshdesk domain. This will trigger an automatic sync of the articles in your "solutions" tab. Additional parameters below can be used to associate data with the synced articles or modify the sync behavior.
result = carbon.integrations.connect_freshdesk(
domain: "string_example",
api_key: "string_example",
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
sync_files_on_connection: true,
request_id: "string_example",
sync_source_items: true,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
data_source_tags: {},
)
p result
StringStringObjectIntegerIntegerBooleanEmbeddingGeneratorsNullableBooleanBooleanBooleanStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
FileSyncConfigNullableObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/freshdesk POST
carbon.integrations.connect_gitbookYou will need an access token to connect your Gitbook account. Note that the permissions will be defined by the user generating access token so make sure you have the permission to access spaces you will be syncing. Refer this article for more details https://developer.gitbook.com/gitbook-api/authentication. Additionally, you need to specify the name of organization you will be syncing data from.
result = carbon.integrations.connect_gitbook(
organization: "string_example",
access_token: "string_example",
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
sync_files_on_connection: true,
request_id: "string_example",
sync_source_items: true,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
data_source_tags: {},
)
p result
StringStringObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanBooleanStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
FileSyncConfigNullableObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/gitbook POST
carbon.integrations.connect_guruYou will need an access token to connect your Guru account. To obtain an access token, follow the steps highlighted here https://help.getguru.com/docs/gurus-api#obtaining-a-user-token. The username should be your Guru username.
result = carbon.integrations.connect_guru(
username: "string_example",
access_token: "string_example",
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
sync_files_on_connection: true,
request_id: "string_example",
sync_source_items: true,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
data_source_tags: {},
)
p result
StringStringObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanBooleanStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
FileSyncConfigNullableObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/guru POST
carbon.integrations.create_aws_iam_userThis endpoint can be used to connect S3 as well as Digital Ocean Spaces (S3 compatible)
For S3, create a new IAM user with permissions to:
result = carbon.integrations.create_aws_iam_user(
access_key: "string_example",
access_key_secret: "string_example",
sync_source_items: true,
endpoint_url: "string_example",
data_source_tags: {},
)
p result
StringStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
StringYou can specify a Digital Ocean endpoint URL to connect a Digital Ocean Space through this endpoint. The URL should be of format .digitaloceanspaces.com. It's not required for S3 buckets.
ObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/s3 POST
carbon.integrations.get_oauth_urlThis endpoint can be used to generate the following URLs
result = carbon.integrations.get_oauth_url(
service: "BOX",
tags: None,
scope: "string_example",
scopes: [],
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
zendesk_subdomain: "string_example",
microsoft_tenant: "string_example",
sharepoint_site_name: "string_example",
confluence_subdomain: "string_example",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
salesforce_domain: "string_example",
sync_files_on_connection: true,
set_page_as_boundary: false,
data_source_id: 1,
connecting_new_account: false,
request_id: "string_example",
use_ocr: false,
parse_pdf_tables_with_ocr: false,
enable_file_picker: true,
sync_source_items: true,
incremental_sync: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
automatically_open_file_picker: true,
gong_account_email: "string_example",
servicenow_credentials: {
"instance_subdomain" => "instance_subdomain_example",
"client_id" => "client_id_example",
"client_secret" => "client_secret_example",
"redirect_uri" => "redirect_uri_example",
},
data_source_tags: {},
)
p result
OauthBasedConnectorsObjectStringString>List of scopes to request from the OAuth provider. Please that the scopes will be used as it is, not combined with the default props that Carbon uses. One scope should be one array element.
IntegerIntegerBooleanEmbeddingGeneratorsNullableStringStringStringStringBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
StringBooleanUsed to specify whether Carbon should attempt to sync all your files automatically when authorization is complete. This is only supported for a subset of connectors and will be ignored for the rest. Supported connectors: Intercom, Zendesk, Gitbook, Confluence, Salesforce, Freshdesk
BooleanIntegerUsed to specify a data source to sync from if you have multiple connected. It can be skipped if you only have one data source of that type connected or are connecting a new account.
BooleanUsed to connect a new data source. If not specified, we will attempt to create a sync URL for an existing data source based on type and ID.
StringThis request id will be added to all files that get synced using the generated OAuth URL
BooleanEnable OCR for files that support it. Supported formats: pdf, png, jpg
BooleanBooleanEnable integration's file picker for sources that support it. Supported sources: BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT
BooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
BooleanOnly sync files if they have not already been synced or if the embedding properties have changed. This flag is currently supported by ONEDRIVE, GOOGLE_DRIVE, BOX, DROPBOX, INTERCOM, GMAIL, OUTLOOK, ZENDESK, CONFLUENCE, NOTION, SHAREPOINT, SERVICENOW. It will be ignored for other data sources.
FileSyncConfigNullableBooleanAutomatically open source file picker after the OAuth flow is complete. This flag is currently supported by BOX, DROPBOX, GOOGLE_DRIVE, ONEDRIVE, SHAREPOINT. It will be ignored for other data sources.
StringIf you are connecting a Gong account, you need to input the email of the account you wish to connect. This email will be used to identify your carbon data source.
ServiceNowCredentialsNullableObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/oauth_url POST
carbon.integrations.list_confluence_pagesThis endpoint has been deprecated. Use /integrations/items/list instead.
To begin listing a user's Confluence pages, at least a data_source_id of a connected
Confluence account must be specified. This base request returns a list of root pages for
every space the user has access to in a Confluence instance. To traverse further down
the user's page directory, additional requests to this endpoint can be made with the same
data_source_id and with parent_id set to the id of page from a previous request. For
convenience, the has_children property in each directory item in the response list will
flag which pages will return non-empty lists of pages when set as the parent_id.
result = carbon.integrations.list_confluence_pages(
data_source_id: 1,
parent_id: "string_example",
)
p result
IntegerString/integrations/confluence/list POST
carbon.integrations.list_conversationsList all of your public and private channels, DMs, and Group DMs. The ID from response
can be used as a filter to sync messages to Carbon
types: Comma separated list of types. Available types are im (DMs), mpim (group DMs), public_channel, and private_channel.
Defaults to public_channel.
cursor: Used for pagination. If next_cursor is returned in response, you need to pass it as the cursor in the next request
data_source_id: Data source needs to be specified if you have linked multiple slack accounts
exclude_archived: Should archived conversations be excluded, defaults to true
result = carbon.integrations.list_conversations(
types: "public_channel",
cursor: "string_example",
data_source_id: 1,
exclude_archived: true,
)
p result
StringStringIntegerBoolean/integrations/slack/conversations GET
carbon.integrations.list_data_source_itemsList Data Source Items
result = carbon.integrations.list_data_source_items(
data_source_id: 1,
parent_id: "string_example",
filters: {
},
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "name",
order_dir: "asc",
)
p result
IntegerStringListItemsFiltersNullablePaginationExternalSourceItemsOrderByOrderDirV2/integrations/items/list POST
carbon.integrations.list_foldersAfter connecting your Outlook account, you can use this endpoint to list all of your folders on outlook. This includes both system folders like "inbox" and user created folders.
result = carbon.integrations.list_folders(
data_source_id: 1,
)
p result
Integer/integrations/outlook/user_folders GET
carbon.integrations.list_gitbook_spacesAfter connecting your Gitbook account, you can use this endpoint to list all of your spaces under current organization.
result = carbon.integrations.list_gitbook_spaces(
data_source_id: 1,
)
p result
Integer/integrations/gitbook/spaces GET
carbon.integrations.list_labelsAfter connecting your Gmail account, you can use this endpoint to list all of your labels. User created labels will have the type "user" and Gmail's default labels will have the type "system"
result = carbon.integrations.list_labels(
data_source_id: 1,
)
p result
Integer/integrations/gmail/user_labels GET
carbon.integrations.list_outlook_categoriesAfter connecting your Outlook account, you can use this endpoint to list all of your categories on outlook. We currently support listing up to 250 categories.
result = carbon.integrations.list_outlook_categories(
data_source_id: 1,
)
p result
Integer/integrations/outlook/user_categories GET
carbon.integrations.list_reposOnce you have connected your GitHub account, you can use this endpoint to list the repositories your account has access to. You can use a data source ID or username to fetch from a specific account.
result = carbon.integrations.list_repos(
per_page: 30,
page: 1,
data_source_id: 1,
)
p result
IntegerIntegerInteger/integrations/github/repos GET
carbon.integrations.list_sharepoint_sitesList all Sharepoint sites in the connected tenant. The site names from the response can be used as the site name when connecting a Sharepoint site. If site name is null in the response, then site name should be left null when connecting to the site.
This endpoint requires an additional Sharepoint scope: "Sites.Read.All". Include this scope along with the default Sharepoint scopes to list Sharepoint sites, connect to a site, and finally sync files from the site. The default Sharepoint scopes are: [o, p, e, n, i, d, , o, f, f, l, i, n, e, _, a, c, c, e, s, s, , U, s, e, r, ., R, e, a, d, , F, i, l, e, s, ., R, e, a, d, ., A, l, l].
data_soure_id: Data source needs to be specified if you have linked multiple Sharepoint accounts cursor: Used for pagination. If next_cursor is returned in response, you need to pass it as the cursor in the next request
result = carbon.integrations.list_sharepoint_sites(
data_source_id: 1,
cursor: "string_example",
)
p result
IntegerString/integrations/sharepoint/sites/list GET
carbon.integrations.sync_azure_blob_filesAfter optionally loading the items via /integrations/items/sync and integrations/items/list, use the container name and file name as the ID in this endpoint to sync them into Carbon. Additional parameters below can associate data with the selected items or modify the sync behavior
result = carbon.integrations.sync_azure_blob_files(
ids: [
{
}
],
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
set_page_as_boundary: false,
data_source_id: 1,
request_id: "string_example",
use_ocr: false,
parse_pdf_tables_with_ocr: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
)
p result
AzureBlobGetFileInput>ObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanIntegerStringBooleanBooleanFileSyncConfigNullable/integrations/azure_blob_storage/files POST
carbon.integrations.sync_azure_blob_storageThis endpoint can be used to connect Azure Blob Storage.
For Azure Blob Storage, follow these steps:
Once created, provide us with the following details to generate the connection URL:
result = carbon.integrations.sync_azure_blob_storage(
account_name: "string_example",
account_key: "string_example",
sync_source_items: true,
data_source_tags: {},
)
p result
StringStringBooleanObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/azure_blob_storage POST
carbon.integrations.sync_confluenceThis endpoint has been deprecated. Use /integrations/files/sync instead.
After listing pages in a user's Confluence account, the set of selected page ids and the
connected account's data_source_id can be passed into this endpoint to sync them into
Carbon. Additional parameters listed below can be used to associate data to the selected
pages or alter the behavior of the sync.
result = carbon.integrations.sync_confluence(
data_source_id: 1,
ids: [
"string_example"
],
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
set_page_as_boundary: false,
request_id: "string_example",
use_ocr: false,
parse_pdf_tables_with_ocr: false,
incremental_sync: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
)
p result
IntegerIdsPropertyObjectIntegerIntegerBooleanEmbeddingGeneratorsNullableBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanStringBooleanBooleanBooleanOnly sync files if they have not already been synced or if the embedding properties have changed. This flag is currently supported by ONEDRIVE, GOOGLE_DRIVE, BOX, DROPBOX, INTERCOM, GMAIL, OUTLOOK, ZENDESK, CONFLUENCE, NOTION, SHAREPOINT, SERVICENOW. It will be ignored for other data sources.
FileSyncConfigNullable/integrations/confluence/sync POST
carbon.integrations.sync_data_source_itemsSync Data Source Items
result = carbon.integrations.sync_data_source_items(
data_source_id: 1,
)
p result
Integer/integrations/items/sync POST
carbon.integrations.sync_filesAfter listing files and folders via /integrations/items/sync and integrations/items/list, use the selected items' external ids as the ids in this endpoint to sync them into Carbon. Sharepoint items take an additional parameter root_id, which identifies the drive the file or folder is in and is stored in root_external_id. That additional paramter is optional and excluding it will tell the sync to assume the item is stored in the default Documents drive.
result = carbon.integrations.sync_files(
data_source_id: 1,
ids: [
"string_example"
],
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
set_page_as_boundary: false,
request_id: "string_example",
use_ocr: false,
parse_pdf_tables_with_ocr: false,
incremental_sync: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
)
p result
IntegerIdsPropertyObjectIntegerIntegerBooleanEmbeddingGeneratorsNullableBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanStringBooleanBooleanBooleanOnly sync files if they have not already been synced or if the embedding properties have changed. This flag is currently supported by ONEDRIVE, GOOGLE_DRIVE, BOX, DROPBOX, INTERCOM, GMAIL, OUTLOOK, ZENDESK, CONFLUENCE, NOTION, SHAREPOINT, SERVICENOW. It will be ignored for other data sources.
FileSyncConfigNullable/integrations/files/sync POST
carbon.integrations.sync_git_hubRefer this article to obtain an access token https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens. Make sure that your access token has the permission to read content from your desired repos. Note that if your access token expires you will need to manually update it through this endpoint.
result = carbon.integrations.sync_git_hub(
username: "string_example",
access_token: "string_example",
sync_source_items: false,
data_source_tags: {},
)
p result
StringStringBooleanEnabling this flag will fetch all available content from the source to be listed via list items endpoint
ObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/github POST
carbon.integrations.sync_gitbookYou can sync upto 20 Gitbook spaces at a time using this endpoint. Additional parameters below can be used to associate data with the synced pages or modify the sync behavior.
result = carbon.integrations.sync_gitbook(
space_ids: [
"string_example"
],
data_source_id: 1,
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
request_id: "string_example",
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
)
p result
String>IntegerObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanStringFileSyncConfigNullable/integrations/gitbook/sync POST
carbon.integrations.sync_gmailOnce you have successfully connected your gmail account, you can choose which emails to sync with us using the filters parameter. Filters is a JSON object with key value pairs. It also supports AND and OR operations. For now, we support a limited set of keys listed below.
label: Inbuilt Gmail labels, for example "Important" or a custom label you created.
after or before: A date in YYYY/mm/dd format (example 2023/12/31). Gets emails after/before a certain date.
You can also use them in combination to get emails from a certain period.
is: Can have the following values - starred, important, snoozed, and unread
from: Email address of the sender
to: Email address of the recipient
in: Can have the following values - sent (sync emails sent by the user)
has: Can have the following values - attachment (sync emails that have attachments)
Using keys or values outside of the specified values can lead to unexpected behaviour.
An example of a basic query with filters can be
{
"filters": {
"key": "label",
"value": "Test"
}
}
Which will list all emails that have the label "Test".
You can use AND and OR operation in the following way:
{
"filters": {
"AND": [
{
"key": "after",
"value": "2024/01/07"
},
{
"OR": [
{
"key": "label",
"value": "Personal"
},
{
"key": "is",
"value": "starred"
}
]
}
]
}
}
This will return emails after 7th of Jan that are either starred or have the label "Personal". Note that this is the highest level of nesting we support, i.e. you can't add more AND/OR filters within the OR filter in the above example.
result = carbon.integrations.sync_gmail(
filters: {},
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
data_source_id: 1,
request_id: "string_example",
sync_attachments: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
incremental_sync: false,
)
p result
ObjectObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanIntegerStringBooleanFileSyncConfigNullableBoolean/integrations/gmail/sync POST
carbon.integrations.sync_outlookOnce you have successfully connected your Outlook account, you can choose which emails to sync with us
using the filters and folder parameter. "folder" should be the folder you want to sync from Outlook. By default
we get messages from your inbox folder.
Filters is a JSON object with key value pairs. It also supports AND and OR operations.
For now, we support a limited set of keys listed below.
category: Custom categories that you created in Outlook.
after or before: A date in YYYY/mm/dd format (example 2023/12/31). Gets emails after/before a certain date. You can also use them in combination to get emails from a certain period.
is: Can have the following values: flagged
from: Email address of the sender
An example of a basic query with filters can be
{
"filters": {
"key": "category",
"value": "Test"
}
}
Which will list all emails that have the category "Test".
Specifying a custom folder in the same query
{
"folder": "Folder Name",
"filters": {
"key": "category",
"value": "Test"
}
}
You can use AND and OR operation in the following way:
{
"filters": {
"AND": [
{
"key": "after",
"value": "2024/01/07"
},
{
"OR": [
{
"key": "category",
"value": "Personal"
},
{
"key": "category",
"value": "Test"
},
]
}
]
}
}
This will return emails after 7th of Jan that have either Personal or Test as category. Note that this is the highest level of nesting we support, i.e. you can't add more AND/OR filters within the OR filter in the above example.
result = carbon.integrations.sync_outlook(
filters: {},
tags: {},
folder: "Inbox",
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
data_source_id: 1,
request_id: "string_example",
sync_attachments: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
incremental_sync: false,
)
p result
ObjectObjectStringIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanIntegerStringBooleanFileSyncConfigNullableBoolean/integrations/outlook/sync POST
carbon.integrations.sync_reposYou can retreive repos your token has access to using /integrations/github/repos and sync their content. You can also pass full name of any public repository (username/repo-name). This will store the repo content with carbon which can be accessed through /integrations/items/list endpoint. Maximum of 25 repositories are accepted per request.
result = carbon.integrations.sync_repos(
repos: [
"string_example"
],
data_source_id: 1,
)
p result
String>Integer/integrations/github/sync_repos POST
carbon.integrations.sync_rss_feedRss Feed
result = carbon.integrations.sync_rss_feed(
url: "string_example",
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
request_id: "string_example",
data_source_tags: {},
)
p result
StringObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanStringObjectTags to be associated with the data source. If the data source already has tags set, then an upsert will be performed.
/integrations/rss_feed POST
carbon.integrations.sync_s3_filesAfter optionally loading the items via /integrations/items/sync and integrations/items/list, use the bucket name and object key as the ID in this endpoint to sync them into Carbon. Additional parameters below can associate data with the selected items or modify the sync behavior
result = carbon.integrations.sync_s3_files(
ids: [
{
}
],
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
max_items_per_chunk: 1,
set_page_as_boundary: false,
data_source_id: 1,
request_id: "string_example",
use_ocr: false,
parse_pdf_tables_with_ocr: false,
file_sync_config: {
"auto_synced_source_types" => ["ARTICLE"],
"sync_attachments" => false,
"detect_audio_language" => false,
"transcription_service" => "assemblyai",
"include_speaker_labels" => false,
"split_rows" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"skip_file_processing" => false,
"parsed_text_format" => "PLAIN_TEXT",
},
)
p result
S3GetFileInput>Each input should be one of the following: A bucket name, a bucket name and a prefix, or a bucket name and an object key. A prefix is the common path for all objects you want to sync. Paths should end with a forward slash.
ObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanIntegerNumber of objects per chunk. For csv, tsv, xlsx, and json files only.
BooleanIntegerStringBooleanBooleanFileSyncConfigNullable/integrations/s3/files POST
carbon.integrations.sync_slackYou can list all conversations using the endpoint /integrations/slack/conversations. The ID of conversation will be used as an input for this endpoint with timestamps as optional filters.
result = carbon.integrations.sync_slack(
filters: {
"conversation_id" => "conversation_id_example",
},
tags: {},
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
embedding_model: "OPENAI",
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
data_source_id: 1,
request_id: "string_example",
)
p result
SlackFiltersObjectIntegerIntegerBooleanEmbeddingGeneratorsBooleanBooleanIntegerString/integrations/slack/sync POST
carbon.organizations.getGet Organization
result = carbon.organizations.get
p result
/organization GET
carbon.organizations.updateUpdate Organization
result = carbon.organizations.update(
global_user_config: {
},
data_source_configs: {
"key": {
"allowed_file_formats" => [],
},
},
)
p result
UserConfigurationNullableDataSourceConfiguration>Used to set organization level defaults for configuration related to data sources.
/organization/update POST
carbon.organizations.update_statsUse this endpoint to reaggregate the statistics for an organization, for example aggregate_file_size. The reaggregation process is asyncronous so a webhook will be sent with the event type being FILE_STATISTICS_AGGREGATED to notify when the process is complee. After this aggregation is complete, the updated statistics can be retrieved using the /organization endpoint. The response of /organization willalso contain a timestamp of the last time the statistics were reaggregated.
result = carbon.organizations.update_stats
p result
/organization/statistics POST
carbon.users.deleteDelete Users
result = carbon.users.delete(
customer_ids: [
"string_example"
],
)
p result
String>/delete_users POST
carbon.users.getUser Endpoint
result = carbon.users.get(
customer_id: "string_example",
)
p result
String/user POST
carbon.users.listList users within an organization
result = carbon.users.list(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
filters: {
},
order_by: "created_at",
order_dir: "asc",
include_count: false,
)
p result
PaginationListUsersFiltersListUsersOrderByTypesOrderDirV2Boolean/list_users POST
carbon.users.toggle_user_featuresToggle User Features
result = carbon.users.toggle_user_features(
configuration_key_name: "sparse_vectors",
value: {},
)
p result
ConfigurationKeysObject/modify_user_configuration POST
carbon.users.update_usersUpdate Users
result = carbon.users.update_users(
customer_ids: [
"string_example"
],
auto_sync_enabled_sources: [
"string_example"
],
max_files: -1,
max_files_per_upload: -1,
max_characters: -1,
max_characters_per_file: -1,
max_characters_per_upload: -1,
auto_sync_interval: -1,
)
p result
String>List of organization supplied user IDs
AutoSyncEnabledSourcesPropertyIntegerCustom file upload limit for the user over all user's files across all uploads. If set, then the user will not be allowed to upload more files than this limit. If not set, or if set to -1, then the user will have no limit.
IntegerCustom file upload limit for the user across a single upload. If set, then the user will not be allowed to upload more files than this limit in a single upload. If not set, or if set to -1, then the user will have no limit.
IntegerCustom character upload limit for the user over all user's files across all uploads. If set, then the user will not be allowed to upload more characters than this limit. If not set, or if set to -1, then the user will have no limit.
IntegerA single file upload from the user can not exceed this character limit. If set, then the file will not be synced if it exceeds this limit. If not set, or if set to -1, then the user will have no limit.
IntegerCustom character upload limit for the user across a single upload. If set, then the user won't be able to sync more than this many characters in one upload. If not set, or if set to -1, then the user will have no limit.
IntegerThe interval in hours at which the user's data sources should be synced. If not set or set to -1, the user will be synced at the organization level interval or default interval if that is also not set. Must be one of [3, 6, 12, 24]
/update_users POST
carbon.users.who_am_iMe Endpoint
result = carbon.users.who_am_i
p result
/whoami GET
carbon.utilities.fetch_urlsExtracts all URLs from a webpage.
Args: url (str): URL of the webpage
Returns: FetchURLsResponse: A response object with a list of URLs extracted from the webpage and the webpage content.
result = carbon.utilities.fetch_urls(
url: "url_example",
)
p result
String/fetch_urls GET
carbon.utilities.fetch_webpageFetch Urls V2
result = carbon.utilities.fetch_webpage(
url: "string_example",
)
p result
String/fetch_webpage POST
carbon.utilities.fetch_youtube_transcriptsFetches english transcripts from YouTube videos.
Args: id (str): The ID of the YouTube video. raw (bool): Whether to return the raw transcript or not. Defaults to False.
Returns: dict: A dictionary with the transcript of the YouTube video.
result = carbon.utilities.fetch_youtube_transcripts(
id: "id_example",
raw: false,
)
p result
StringBoolean/fetch_youtube_transcript GET
carbon.utilities.process_sitemapRetrieves all URLs from a sitemap, which can subsequently be utilized with our web_scrape endpoint.
result = carbon.utilities.process_sitemap(
url: "url_example",
)
p result
String/process_sitemap GET
carbon.utilities.scrape_sitemapExtracts all URLs from a sitemap and performs a web scrape on each of them.
Args: sitemap_url (str): URL of the sitemap
Returns: dict: A response object with the status of the scraping job message.-->
result = carbon.utilities.scrape_sitemap(
url: "string_example",
tags: {
"key": "string_example",
},
max_pages_to_scrape: 1,
chunk_size: 1500,
chunk_overlap: 20,
skip_embedding_generation: false,
enable_auto_sync: false,
generate_sparse_vectors: false,
prepend_filename_to_chunks: false,
html_tags_to_skip: [],
css_classes_to_skip: [],
css_selectors_to_skip: [],
embedding_model: "OPENAI",
url_paths_to_include: [],
url_paths_to_exclude: [],
urls_to_scrape: [],
download_css_and_media: false,
generate_chunks_only: false,
store_file_only: false,
use_premium_proxies: false,
)
p result
StringTags1>IntegerIntegerIntegerBooleanBooleanBooleanBooleanString>String>String>EmbeddingGeneratorsString>URL subpaths or directories that you want to include. For example if you want to only include URLs that start with /questions in stackoverflow.com, you will add /questions/ in this input
String>URL subpaths or directories that you want to exclude. For example if you want to exclude URLs that start with /questions in stackoverflow.com, you will add /questions/ in this input
String>You can submit a subset of URLs from the sitemap that should be scraped. To get the list of URLs, you can check out /process_sitemap endpoint. If left empty, all URLs from the sitemap will be scraped.
BooleanWhether the scraper should download css and media from the page (images, fonts, etc). Scrapes might take longer to finish with this flag enabled, but the success rate is improved.
BooleanIf this flag is enabled, the file will be chunked and stored with Carbon, but no embeddings will be generated. This overrides the skip_embedding_generation flag.
BooleanIf this flag is enabled, the file will be stored with Carbon, but no processing will be done.
BooleanIf the default proxies are blocked and not returning results, this flag can be enabled to use alternate proxies (residential and office). Scrapes might take longer to finish with this flag enabled.
/scrape_sitemap POST
carbon.utilities.scrape_webConduct a web scrape on a given webpage URL. Our web scraper is fully compatible with JavaScript and supports recursion depth, enabling you to efficiently extract all content from the target website.
result = carbon.utilities.scrape_web(
body: [
{
"url" => "url_example",
"recursion_depth" => 3,
"max_pages_to_scrape" => 100,
"chunk_size" => 1500,
"chunk_overlap" => 20,
"skip_embedding_generation" => false,
"enable_auto_sync" => false,
"generate_sparse_vectors" => false,
"prepend_filename_to_chunks" => false,
"html_tags_to_skip" => [],
"css_classes_to_skip" => [],
"css_selectors_to_skip" => [],
"embedding_model" => "OPENAI",
"url_paths_to_include" => [],
"download_css_and_media" => false,
"generate_chunks_only" => false,
"store_file_only" => false,
"use_premium_proxies" => false,
}
],
)
p result
Array<WebscrapeRequest>
/web_scrape POST
carbon.utilities.search_urlsPerform a web search and obtain a list of relevant URLs.
As an illustration, when you perform a search for “content related to MRNA,” you will receive a list of links such as the following:
- https://tomrenz.substack.com/p/mrna-and-why-it-matters
- https://www.statnews.com/2020/11/10/the-story-of-mrna-how-a-once-dismissed-idea-became-a-leading-technology-in-the-covid-vaccine-race/
- https://www.statnews.com/2022/11/16/covid-19-vaccines-were-a-success-but-mrna-still-has-a-delivery-problem/
- https://joomi.substack.com/p/were-still-being-misled-about-how
Subsequently, you can submit these links to the web_scrape endpoint in order to retrieve the content of the respective web pages.
Args: query (str): Query to search for
Returns: FetchURLsResponse: A response object with a list of URLs for a given search query.
result = carbon.utilities.search_urls(
query: "query_example",
)
p result
String/search_urls GET
carbon.utilities.user_webpagesUser Web Pages
result = carbon.utilities.user_webpages(
filters: {
},
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "asc",
)
p result
UserWebPagesFiltersPaginationUserWebPageOrderByTypesOrderDirV2/user_webpages POST
carbon.webhooks.add_urlAdd Webhook Url
result = carbon.webhooks.add_url(
url: "string_example",
)
p result
String/add_webhook POST
carbon.webhooks.delete_urlDelete Webhook Url
result = carbon.webhooks.delete_url(
webhook_id: 1,
)
p result
Integer/delete_webhook/{webhook_id} DELETE
carbon.webhooks.urlsWebhook Urls
result = carbon.webhooks.urls(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"ids" => [],
},
)
p result
PaginationWebhookOrderByColumnsOrderDirWebhookFilters/webhooks POST
carbon.white_label.createCreate White Labels
result = carbon.white_label.create(
body: [
{
"data_source_type" => "GOOGLE_DRIVE",
"credentials" => {
"client_id" => "client_id_example",
"redirect_uri" => "redirect_uri_example",
},
}
],
)
p result
Array<WhiteLabelCreateRequestInner>
/white_label/create POST
carbon.white_label.deleteDelete White Labels
result = carbon.white_label.delete(
ids: [
1
],
)
p result
Integer>/white_label/delete POST
carbon.white_label.listList White Labels
result = carbon.white_label.list(
pagination: {
"limit" => 10,
"offset" => 0,
"starting_id" => 0,
},
order_by: "created_at",
order_dir: "desc",
filters: {
"ids" => [],
"data_source_type" => [],
},
)
p result
PaginationWhiteLabelOrderByColumnsOrderDirWhiteLabelFilters/white_label/list POST
carbon.white_label.updateUpdate White Label
result = carbon.white_label.update(
data_source_type: "INTERCOM",
credentials: {
"client_id" => "client_id_example",
"redirect_uri" => "redirect_uri_example",
},
body: {
"data_source_type" => "GOOGLE_DRIVE",
"credentials" => {
"client_id" => "client_id_example",
"redirect_uri" => "redirect_uri_example",
},
},
)
p result
WhiteLabelInputDataSourceTypeCredentials/white_label/update POST
This TypeScript package is automatically generated by Konfig
FAQs
Unknown package
We found that carbon_ruby_sdk demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.