Bulk operations

Bulk data upload

Import URLs and context from CSV

Bulk uploads let you seed Outtake with large batches of content in a single import. Use this guide to prepare your CSV, understand each column, and verify that your upload succeeded.

Overview

  • Upload target: Outtake dashboard → Bulk data upload
  • Accepted format: UTF-8 CSV, headers required
  • Authentication: Same session as the dashboard (no API token required)

CSV schema

Your CSV must include the following headers in this exact order:

ColumnTypeRequiredNotes
URLstring (URL)YesAbsolute URL to the content you want to ingest.
ContextstringYesNarrative or investigative notes about the URL (can reference off-platform context, max 2,000 chars).
Classificationsstring (comma-separated)NoOptional hints for the agent. Use any combination of phishing, malware, policy_violation, brand_abuse.

Sample file

1URL,Context,Classifications
2https://example.com/article-1,"Recap of top viral narratives about deepfakes from customer escalations","phishing,malware"
3https://example.com/post-42,"Match flagged by client investigations team referencing internal ticket 1423","brand_abuse"

Preparing your data

  1. Normalize URLs – Use canonical URLs where possible. Duplicates in the same upload will be deduplicated by the last row encountered.
  2. Provide actionable context – Context is surfaced to reviewers and downstream automation, so summarize the narrative or why the content matters.
  3. Add classifications when known – Supplying one or more classification hints improves agent accuracy; separate values with commas and stick to the supported list.

Uploading the CSV

  1. Sign in to the Outtake dashboard and navigate to Bulk data upload.
  2. Drag and drop your CSV or choose the file picker.
  3. Review the preview table to confirm each column mapped correctly.
  4. Confirm the Classifications column mapped correctly when present.
  5. Click Upload to start ingestion.

Validation & errors

  • Rows failing validation (missing URL, invalid boolean, unsupported classification value, etc.) are skipped and reported in the upload summary.
  • Large uploads may process asynchronously. You will receive an in-product notification when processing completes.
  • For repeated failures, download the error report to review row-level details.

Verifying the import

  • Use the Recent uploads panel to check status and row counts.
  • If you added classifications, check that the agent sees the supplied hints in the classification sidebar.

Troubleshooting

  • Invalid URL: Ensure the value includes the scheme (https://). Redirect-only URLs are rejected.
  • Context too long: Trim descriptions to 2,000 characters or fewer.
  • Unexpected classification result: Upload an updated row with refined context or classification hints to steer the agent.

Need help? Reach out to support@outtake.ai with the upload ID and we’ll investigate.