Arguments
| Argument | Required | Description |
|---|---|---|
project_id | Yes | The project UUID |
file_path | No | Path to the PDF file |
Options
| Option | Short | Description |
|---|---|---|
--base64 <string> | — | Base64-encoded file content (alternative to file_path) |
--file-name <name> | — | File name (required with --base64) |
--extractions <list> | — | Comma-separated list of extraction types to run after upload |
Extraction Types
| Extraction | Description |
|---|---|
extract-accounting-period | Accounting period definitions |
extract-assets | Asset references |
extract-commitments | Commitment clauses |
extract-compensations | Compensation terms |
extract-control-areas | Control area definitions |
extract-costs | Cost provisions |
extract-creative-approvals | Creative approval clauses |
extract-dates | Key dates (effective, termination, etc.) |
extract-royalties | Royalty terms |
extract-signatures | Signature information |
extract-splits | Revenue split information |
extract-targets | Target and threshold clauses |
Behavior
- You must provide either
file_pathor--base64, but not both - When using
--base64,--file-nameis required --extractionsis optional — when omitted, the default extraction pipeline runs after staging completes- On success, prints the staging ID and a hint to track progress with
royaltyport contracts status
Output
Prints a table with upload details:| Field | Description |
|---|---|
| Staging ID | Unique identifier for tracking processing progress |
| Staging Stage | Current processing stage (queued, processing, completed, failed) |
| Staging Done | Whether staging (pre-processing) has completed |
| Extractions Done | Whether all extractions have completed |
| Created At | Upload timestamp |