agent adl upload
Upload a file to an SFDRIVE Agentforce Data Library.
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.
| Flag Name (Long) | Flag Name (Short) | Description |
|---|---|---|
‑‑api‑version | N/A | Type: Value Override the api version used for api requests made by this command |
‑‑file | ‑f | Type: Value Required Path to the file to upload. |
‑‑flags‑dir | N/A | Type: Value Import flag values from a directory. |
‑‑json | N/A | Type: Boolean Format output as json. |
‑‑library‑id | ‑i | Type: Value Required Agentforce Data Library ID (18-char Salesforce ID with prefix 1JD). |
‑‑target‑org | ‑o | Type: Value Required Username or alias of the target org. Not required if the target-org configuration variable is already set. |
‑‑wait | ‑w | Type: Value Number of minutes to wait for indexing to complete. If not specified, returns after triggering indexing. |
Upload a file and wait for indexing to complete:
Upload a file without waiting: