Upload a file to an SFDRIVE Agentforce Data Library.
Description for agent adl upload
Performs the multi-step upload workflow: checks upload readiness, obtains a pre-signed S3 URL, uploads the file, triggers indexing, and optionally polls until the library is ready (retrieverId is populated).
Upload triggers the full Data Cloud provisioning pipeline, creating all downstream assets (DLO, DMO, SearchIndex, Retriever). Use sf agent adl status to monitor progress. For adding files to an already-provisioned library, use sf agent adl file add instead.
This command only works with SFDRIVE libraries. KNOWLEDGE libraries index automatically after creation, and RETRIEVER libraries require no file upload.
Flags
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
| <code>‑‑api‑version</code> | N/A | Type: Value<br><br>Override the api version used for api requests made by this command |
| <code>‑‑file</code> | <code>‑f</code> | Type: Value<br>Required<br><br>Path to the file to upload. |
| <code>‑‑flags‑dir</code> | N/A | Type: Value<br><br>Import flag values from a directory. |
| <code>‑‑json</code> | N/A | Type: Boolean<br><br>Format output as json. |
| <code>‑‑library‑id</code> | <code>‑i</code> | Type: Value<br>Required<br><br>Agentforce Data Library ID (18-char Salesforce ID with prefix 1JD). |
| <code>‑‑target‑org</code> | <code>‑o</code> | Type: Value<br>Required<br><br>Username or alias of the target org. Not required if the target-org configuration variable is already set. |
| <code>‑‑wait</code> | <code>‑w</code> | Type: Value<br><br>Number of minutes to wait for indexing to complete. If not specified, returns after triggering indexing. |
Examples for agent adl upload
Upload a file and wait for indexing to complete:
sf agent adl upload --library-id 1JDSG000007IbWX4A0 --file ./docs/guide.pdf --target-org myOrg --wait 10
Upload a file without waiting:
sf agent adl upload --library-id 1JDSG000007IbWX4A0 --file ./docs/guide.pdf --target-org myOrg