Data Source
List Connection Items
API Documentation
Health
Files
Web Scrape
Data Source
SharePoint
GitHub
Chunks / Embeddings
Retrieval
Data Source
List Connection Items
Use this endpoint to access and navigate a user’s file directory, allowing you to create a custom file selector interface.
POST
/
integrations
/
items
/
list
curl --request POST \
--url https://api.carbon.ai/integrations/items/list \
--header 'Content-Type: application/json' \
--header 'authorization: <api-key>' \
--data '{
"data_source_id": 123,
"parent_id": "<string>",
"filters": {
"external_ids": [
"<string>"
],
"ids": [
123
],
"name": "<string>",
"root_files_only": true,
"file_formats": [
"TXT"
],
"item_types": [
"FILE"
]
},
"pagination": {
"limit": 10,
"offset": 0,
"starting_id": 0
},
"order_by": "name",
"order_dir": "asc"
}'
{
"items": [
{
"id": 123,
"external_id": "<string>",
"source": "GOOGLE_CLOUD_STORAGE",
"name": "<string>",
"synced_at": "2023-11-07T05:31:56Z",
"is_selectable": true,
"is_expandable": true,
"organization_id": 123,
"organization_supplied_user_id": "<string>",
"organization_user_id": 123,
"organization_user_data_source_id": 123,
"organization_user_file_to_sync_id": 123,
"parent_external_id": "<string>",
"item_type": "<string>",
"root_external_id": "<string>",
"external_url": "<string>",
"file_format": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123
}
Authorizations
token <token>
, corresponds to temporary access tokens.
Body
application/json
Available options:
TXT
, CSV
, TSV
, PDF
, DOCX
, PPTX
, XLSX
, XLSM
, MD
, RTF
, JSON
, HTML
, HTML
, JPG
, JPG
, PNG
, MP3
, MP2
, AAC
, WAV
, FLAC
, PCM
, M4A
, OGG
, OPUS
, MPEG
, MPG
, MP4
, WMV
, AVI
, MOV
, MKV
, FLV
, WEBM
, EML
, MSG
Available options:
FILE
, FOLDER
Available options:
name
, id
, directories_first
Available options:
asc
, desc
Response
200
application/json
Successful Response
Available options:
GOOGLE_CLOUD_STORAGE
, GOOGLE_DRIVE
, NOTION
, NOTION_DATABASE
, INTERCOM
, DROPBOX
, ONEDRIVE
, SHAREPOINT
, CONFLUENCE
, BOX
, ZENDESK
, ZOTERO
, S3
, AZURE_BLOB_STORAGE
, GMAIL
, OUTLOOK
, SERVICENOW
, TEXT
, CSV
, TSV
, PDF
, DOCX
, PPTX
, XLSX
, XLSM
, MD
, RTF
, JSON
, HTML
, RAW_TEXT
, WEB_SCRAPE
, RSS_FEED
, FRESHDESK
, GITBOOK
, SALESFORCE
, GITHUB
, SLACK
, GURU
, GONG
, DOCUMENT360
, JPG
, PNG
, JPEG
, MP3
, MP2
, AAC
, WAV
, FLAC
, PCM
, M4A
, OGG
, OPUS
, MPEG
, MPG
, MP4
, WMV
, AVI
, MOV
, MKV
, FLV
, WEBM
, EML
, MSG
curl --request POST \
--url https://api.carbon.ai/integrations/items/list \
--header 'Content-Type: application/json' \
--header 'authorization: <api-key>' \
--data '{
"data_source_id": 123,
"parent_id": "<string>",
"filters": {
"external_ids": [
"<string>"
],
"ids": [
123
],
"name": "<string>",
"root_files_only": true,
"file_formats": [
"TXT"
],
"item_types": [
"FILE"
]
},
"pagination": {
"limit": 10,
"offset": 0,
"starting_id": 0
},
"order_by": "name",
"order_dir": "asc"
}'
{
"items": [
{
"id": 123,
"external_id": "<string>",
"source": "GOOGLE_CLOUD_STORAGE",
"name": "<string>",
"synced_at": "2023-11-07T05:31:56Z",
"is_selectable": true,
"is_expandable": true,
"organization_id": 123,
"organization_supplied_user_id": "<string>",
"organization_user_id": 123,
"organization_user_data_source_id": 123,
"organization_user_file_to_sync_id": 123,
"parent_external_id": "<string>",
"item_type": "<string>",
"root_external_id": "<string>",
"external_url": "<string>",
"file_format": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
],
"count": 123
}