Paper Endpoint

GET /dev/paper?id=<paper-id>
GET /dev/paper?slug=<paper-slug>
x-api-key: <your-api-key>

interface PaperEndpointResponse {
  paper: PaperDoc
}

interface PaperDoc {
  paperId: string
  collectionId: string | null
  projectId: string | null
  ownerId: string | null          // masked in Dev API
  thumbnailUrl: string | null
  title: string
  slug: string
  body: string                    // Markdown content
  status: "draft" | "published" | "archived"
  metadata: PaperMetadata | null
  createdAt: string               // ISO 8601
  updatedAt: string               // ISO 8601
}

interface PaperMetadata {
  title: string
  metaDescription: string
  canonical: string
  robots: string
  ogTitle: string
  ogDescription: string
  ogImage: string
  ogImageWidth: number            // default 1200
  ogImageHeight: number           // default 630
  ogImageAlt: string
  ogLocale: string                // default "en_US"
  ogPublishedTime: string         // ISO 8601
  ogModifiedTime: string          // ISO 8601
  ogAuthorUrl: string
  ogTags: string[]
  twitterTitle: string
  twitterDescription: string
  twitterImage: string
  twitterImageAlt: string
  twitterCreator: string | null
  headline: string
  abstract: string
  keywords: string
  articleSection: string
  wordCount: number
  readingTimeMinutes: number
  inLanguage: string
  datePublished: string           // ISO 8601
  dateModified: string            // ISO 8601
  authorName: string
  authorHandle: string
  authorUrl: string
  authorId: string
  coverImageUrl: string
  publisherName: string
  publisherUrl: string
  isAccessibleForFree: boolean
  license: string
  keyTakeaways: string[] | null
  faq: Array<{ question: string; answer: string }> | null
  authorBio: string | null
  jsonLd: Record<string, any> | Record<string, any>[] | null
}