Artifacts

The intellia artifact command group manages artifacts — files produced by or attached to conversations, workflow executions, and the org library. Use it to publish a local file, list and inspect artifacts, download their bytes, share them via a public link, promote them into the org library, forward them into a knowledge base, or delete the ones you’re done with.

All subcommands authenticate with INTELLIA_ORG_ID and INTELLIA_API_KEY (or .intelliarc.yaml / ~/.intellia/credentials). Conversation- and workflow-scoped commands read context from INTELLIA_CONVERSATION_ID and INTELLIA_WORKFLOW_EXECUTION_ID when the matching flag is omitted. Every subcommand accepts --json for machine-readable output.

Subcommands

publish

Publish a local file as an artifact. The display title comes from --name, but the filename and MIME type are always inferred from the file’s actual basename. Artifacts are scoped to a conversation by default, or to a workflow execution when running inside a workflow sandbox.

intellia artifact publish ./report.pdf --name "Q2 Report"
intellia artifact publish ./out.csv --conversation-id conv_123 --push-to-canvas
intellia artifact publish ./v2.pdf --append-to art_456

--conversation-id and --workflow-execution-id are mutually exclusive. --push-to-canvas requires a conversation context — pass --conversation-id or set INTELLIA_CONVERSATION_ID.

list

List artifacts. Defaults to the org library; pass --conversation or --workflow-execution-id to scope to a conversation or a specific workflow execution.

intellia artifact list
intellia artifact list --conversation --conversation-id conv_123
intellia artifact list --search "invoice" --kind pdf --limit 100

get

Fetch an artifact’s metadata and signed URLs (inline and download). The signed URLs expire — urlExpiresAt is shown in the output.

intellia artifact get art_456
intellia artifact get art_456 --json

download

Stream an artifact’s bytes to a local path via its signed URL. Safe for files up to the 100 MB cap. Defaults the output path to ./<sanitised-filename> in the current directory.

intellia artifact download art_456
intellia artifact download art_456 --out ./report.pdf --checksum

With --checksum, a mismatch fails the command with a checksum_mismatch error rather than leaving a corrupt file unflagged.

share

Create a public share link for an artifact. Optionally set a title, description, and expiry.

intellia artifact share art_456
intellia artifact share art_456 --title "Signed lease" --expires-in 7d
intellia artifact share art_456 --expires-in 2026-09-01T00:00:00Z

The command prints the public shareUrl and the shareId.

promote

Promote an artifact to the org library, making it available across the organization rather than only within its originating conversation or workflow execution.

intellia artifact promote art_456

This command takes no options beyond --json.

send-to-kb

Forward a chat artifact into a knowledge base. The artifact’s bytes are downloaded and then ingested through the KB pipeline. Use this when adding an artifact to a knowledge base — not for moving it into the org library (that’s intellia artifact promote).

intellia artifact send-to-kb art_456 kb_789
intellia artifact send-to-kb art_456 kb_789 --wait --timeout 600
intellia artifact send-to-kb art_456 kb_789 --filename "lease-2026.pdf"

Without --wait, the file is queued for ingestion and the command returns immediately. With --wait, the command exits non-zero if ingestion ends in ERROR or the timeout elapses while the file is still pending.

pin

Pin an HTML artifact as an App. “Apps” are pinned HTML artifacts — pinning is what makes one show up there. Non-app artifacts (no hutly.manifest.ts scope) and apps whose declared scope is already approved pin directly.

An app whose declared manifest is not yet approved is refused: the command prints the declared workflow/table scope and exits non-zero without pinning. Re-run with --approve to approve that scope and pin in one step.

An app whose embedded manifest is malformed (invalid JSON or shape) is refused even with --approve — a malformed manifest can’t be approved, and pinning it would ship an app whose window.hutly calls fail at runtime. Rebuild and republish the app, then pin.

intellia artifact pin art_456
intellia artifact pin art_456 --approve

Refused (unapproved, no --approve):

This app is not yet approved. Declared scope:
  Workflows: create-lead
  Tables:
    - leads (write)
Re-run with --approve to approve this scope and pin.
Error: Unapproved app: re-run with --approve to pin it.

unpin

Remove an artifact from Apps. The artifact itself is untouched — it stays in the library.

intellia artifact unpin art_456

This command takes no options beyond --json.

rename

Rename an artifact’s display name. Does not touch the filename, MIME type, or any artifact version.

intellia artifact rename art_456 "Lead Intake"

This command takes no options beyond --json.

reorder

Set the manual display order of the org’s pinned Apps. Pass every pinned artifact ID in the desired order — each gets its position recorded.

intellia artifact reorder art_456 art_789 art_123

This command takes no options beyond --json.

delete

Remove an artifact from the library and revoke any public share links to it. The artifact stops being reachable but is not scrubbed from backups.

intellia artifact delete art_456

Prints how many share links were revoked, and warns if a share’s CDN mirror could not be cleared — those URLs may serve cached copies until their TTL expires.