---
title: "Import Records"
method: POST
path: "/admin/editorial/workspace/import"
tags: ["editorial admin"]
---

# Import Records

`POST /admin/editorial/workspace/import`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/admin/editorial/workspace/import`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Request body

- Import
  - `schema_version` string, required
  - `records` Save[], required
    - `expected_revision` integer, required
    - `record` Record, required
      - `key` string, required
      - `kind` 'story' | 'contact' | 'draft', required
      - `title` string, required
      - `notes` string
      - `story_key` string, nullable
      - `contact_key` string, nullable
      - `channel` 'instagram' | 'x' | 'reddit' | 'email' | 'substack' | 'website', nullable
      - `target` string
      - `purpose` 'publication' | 'initial' | 'followup' | 'reply'
      - `sources` string[]
      - `identities` string[]
      - `pieces` Piece[]
        - `text` string
        - `assets` Asset[]
          - `sha256` string, required
          - `alt` string, required
      - `next_action` string
      - `due_at` string, date-time, nullable
      - `evidence_as_of` string, date-time, nullable
      - `checkpoint` string
      - `owner` string
  - `observations` HistoricalEvent[]
    - `key` string, required
    - `event` Event, required
      - `operation_id` string, uuid, required
      - `expected_revision` integer, required
      - `content_sha256` string, required
      - `action` 'approve' | 'revoke' | 'complete' | 'park' | 'resume' | 'opt_out' | 'observation' | 'publication_request' | 'schedule' | 'cancel_schedule', required
      - `confirmed` boolean
      - `occurred_at` string, date-time, nullable
      - `reference` string
      - `note` string
      - `outcome` 'sent' | 'reply' | 'interested' | 'trial' | 'use' | 'external_schedule' | 'exposure' | 'signup' | 'cancelled', nullable
      - `purpose` 'initial' | 'followup' | 'reply' | 'publication', nullable
      - `channel` 'instagram' | 'x' | 'reddit' | 'email' | 'substack' | 'website', nullable
      - `metrics` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)