Connect to file sources including S3 buckets and direct URLs
Connectors describe the source of your files. Each job uses exactly one connector. The connector produces one or more inputs and provides a stable identifier for each input (for example, an S3 object key or a URL). That identifier is echoed back in responses so you can map results to the original files.
S3
Read files from an Amazon S3 bucket (or S3‑compatible storage).
URLs
Provide direct links to files (e.g., pre‑signed S3 URLs) that we can download.
File uploads
Upload files to Trelent once and reuse their IDs across jobs.
⌘I
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Trelent Docs","description":"Documentation for Trelent Data Ingestion, Agents, and Document Verification.","colors":{"primary":"#36c1da","light":"#36c1da","dark":"#36c1da"},"favicon":"https://www.trelent.com/trelent-favicon.png","api":{"playground":{"display":"simple"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"trelent","hasAudioNarration":false,"actualSubdomain":"trelent","customDomains":["docs.trelent.com"],"gitSource":{"type":"github","owner":"trelent","repo":"docs.trelent.com","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aa092c86b56d9f150533363","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Data Ingestion","count":22},{"language":"default","tag":"Document Verification","count":11},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Getting started","count":10},{"language":"default","tag":"Core concepts","count":6},{"language":"default","tag":"API reference","count":6},{"language":"default","tag":"Connectors","count":4},{"language":"default","tag":"Admin","count":4},{"language":"default","tag":"Detections","count":4},{"language":"default","tag":"Configuration","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"data-ingestion/connectors","slug":"/data-ingestion/connectors","pageMetadata":{"title":"Connectors","description":"Connect to file sources including S3 buckets and direct URLs","mode":"wide","href":"/data-ingestion/connectors/index"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect to file sources including S3 buckets and direct URLs\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Card,Columns}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Connectors describe the source of your files. Each job uses exactly one connector. The connector produces one or more inputs and provides a stable identifier for each input (for example, an S3 object key or a URL). That identifier is echoed back in responses so you can map results to the original files.`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`S3`,icon:`aws`,href:`/data-ingestion/connectors/s3`,arrow:`true`,cta:`View S3 Connector`,children:_jsx(_components.p,{children:`Read files from an Amazon S3 bucket (or S3‑compatible storage).`})}),_jsx(Card,{title:`URLs`,icon:`link`,href:`/data-ingestion/connectors/presigned-urls`,arrow:`true`,cta:`View URL Connector`,children:_jsx(_components.p,{children:`Provide direct links to files (e.g., pre‑signed S3 URLs) that we can download.`})}),_jsx(Card,{title:`File uploads`,icon:`file`,href:`/data-ingestion/connectors/file-upload`,arrow:`true`,cta:`View File Connector`,children:_jsx(_components.p,{children:`Upload files to Trelent once and reuse their IDs across jobs.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connectors","description":"Connect to file sources including S3 buckets and direct URLs","mode":"wide","href":"/data-ingestion/connectors/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"trelent","siteName":"Trelent Docs","title":"Connectors - Trelent Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-28T00:34:00.196Z","originalFileLocation":"data-ingestion/connectors/index.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect to file sources including S3 buckets and direct URLs\">\u003cmeta data-mint-head name=\"application-name\" content=\"Trelent Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://www.trelent.com/trelent-favicon.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connectors - Trelent Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect to file sources including S3 buckets and direct URLs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Trelent Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.trelent.com/data-ingestion/connectors\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://trelent.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connectors\u0026amp;description=Connect+to+file+sources+including+S3+buckets+and+direct+URLs\u0026amp;theme=5f92e974fee7788b9d0d104e\u0026amp;signature=256c2c86b5afb7d49bebe55c8ede4820bcd916e342e0b4660915d91c00601d9a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connectors - Trelent Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect to file sources including S3 buckets and direct URLs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://trelent.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Connectors\u0026amp;description=Connect+to+file+sources+including+S3+buckets+and+direct+URLs\u0026amp;theme=5f92e974fee7788b9d0d104e\u0026amp;signature=256c2c86b5afb7d49bebe55c8ede4820bcd916e342e0b4660915d91c00601d9a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/trelent/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Trelent Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#36c1da\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.trelent.com/data-ingestion/connectors\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/data-ingestion/connectors.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.trelent.com/#organization\",\"name\":\"Trelent Docs\",\"url\":\"https://docs.trelent.com\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.trelent.com#website\",\"name\":\"Trelent Docs\",\"url\":\"https://docs.trelent.com\",\"publisher\":{\"@id\":\"https://docs.trelent.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.trelent.com/data-ingestion/connectors#webpage\",\"url\":\"https://docs.trelent.com/data-ingestion/connectors\",\"name\":\"Connectors\",\"description\":\"Connect to file sources including S3 buckets and direct URLs\",\"dateModified\":\"2026-03-28T00:34:00.196Z\",\"isPartOf\":{\"@id\":\"https://docs.trelent.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.trelent.com/data-ingestion/connectors#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.trelent.com/data-ingestion/connectors#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connectors\",\"item\":\"https://docs.trelent.com/data-ingestion/connectors/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connectors\",\"item\":\"https://docs.trelent.com/data-ingestion/connectors\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.trelent.com/data-ingestion/connectors#article\",\"headline\":\"Connectors\",\"name\":\"Connectors\",\"description\":\"Connect to file sources including S3 buckets and direct URLs\",\"url\":\"https://docs.trelent.com/data-ingestion/connectors\",\"mainEntityOfPage\":{\"@id\":\"https://docs.trelent.com/data-ingestion/connectors#webpage\"},\"dateModified\":\"2026-03-28T00:34:00.196Z\",\"publisher\":{\"@id\":\"https://docs.trelent.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.trelent.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Trelent Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Trelent Docs","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Agents","pages":[{"title":"Agents","href":"/agents"}]},{"tab":"Data Ingestion","groups":[{"group":"Getting started","icon":"play","expanded":false,"pages":[{"title":"Data Ingestion","sidebarTitle":"Overview","mode":"wide","href":"/data-ingestion"},{"title":"Quickstart: Process uploaded files","description":"Upload a local file, run it through the Data Ingestion pipeline, and pull the results back.","href":"/data-ingestion/quickstart"}]},{"group":"Architecture","icon":"sitemap","hidden":true,"pages":[{"title":"Architecture Overview","sidebarTitle":"Overview","description":"Understand how the Trelent Data Ingestion API is structured and how its components work together.","mode":"wide","href":"/data-ingestion/architecture/index"},{"title":"Deployment Architecture","sidebarTitle":"Deployment","description":"A Kubernetes-native, cloud-agnostic platform that runs wherever your data lives.","href":"/data-ingestion/architecture/deployment"},{"title":"Data Flow \u0026 Job Lifecycle","sidebarTitle":"Data Flow","description":"Follow a job from submission through processing to result retrieval.","href":"/data-ingestion/architecture/data-flow"},{"title":"Connectors \u0026 Extensibility","sidebarTitle":"Connectors","description":"How input and output connectors abstract data sources and destinations.","href":"/data-ingestion/architecture/connectors"},{"title":"Security \u0026 Data Residency","sidebarTitle":"Security","description":"How the platform keeps data within your controlled environment.","href":"/data-ingestion/architecture/security"},{"title":"Scaling \u0026 Throughput","sidebarTitle":"Scaling","description":"How the platform handles high throughput and large file volumes.","href":"/data-ingestion/architecture/scaling"}]},{"group":"Connectors","icon":"plug","pages":[{"title":"Connectors","mode":"wide","href":"/data-ingestion/connectors/index"},{"title":"S3 Connector","description":"Connect to files stored in Amazon S3 buckets or S3-compatible storage","href":"/data-ingestion/connectors/s3"},{"title":"URL Connector","href":"/data-ingestion/connectors/presigned-urls"},{"title":"File connector","href":"/data-ingestion/connectors/file-upload"}]},{"group":"Configuration","icon":"sliders","pages":[{"title":"Processing config","mode":"wide","href":"/data-ingestion/config/index"},{"title":"Document processing config","href":"/data-ingestion/config/documents"},{"title":"Video processing config","href":"/data-ingestion/config/video"}]},{"group":"Outputs","icon":"arrow-up-from-bracket","pages":[{"title":"Outputs","mode":"wide","href":"/data-ingestion/outputs/index"},{"title":"S3 Output","href":"/data-ingestion/outputs/s3"},{"title":"URL Output","href":"/data-ingestion/outputs/presigned-urls"}]},{"group":"Jobs","icon":"clock","pages":[{"title":"Create a job","sidebarTitle":"Creating jobs","href":"/data-ingestion/jobs/creating"},{"title":"Poll job status","sidebarTitle":"Polling jobs","href":"/data-ingestion/jobs/polling"},{"title":"Job status \u0026 progress","sidebarTitle":"Status \u0026 progress","href":"/data-ingestion/jobs/status"}]},{"group":"Files","icon":"file-arrow-up","pages":[{"title":"File management","sidebarTitle":"Overview","href":"/data-ingestion/files/index"},{"title":"Upload files","href":"/data-ingestion/files/upload"},{"title":"List files","href":"/data-ingestion/files/list"}]},{"group":"Admin","icon":"lock","pages":[{"title":"Token management","sidebarTitle":"Overview","href":"/data-ingestion/tokens/index"},{"title":"Generate tokens","href":"/data-ingestion/tokens/generate"},{"title":"List tokens","href":"/data-ingestion/tokens/list"},{"title":"Revoke tokens","href":"/data-ingestion/tokens/revoke"}]}]},{"tab":"Document Verification","pages":[{"title":"Document Verification","href":"/document-verification"}]}]},"basePath":"","title":"Connectors - Trelent Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":[],"chunks":[]}