---
title: "Get idea"
method: GET
path: "/ideas/{id}"
tags: ["Ideas"]
---

# Get idea

`GET /ideas/{id}`

Get a single idea by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

Idea details

- object
  - `idea` Idea — Content idea that can be converted to a calendar post
    - `id` string, uuid
    - `url` string, uri
    - `title` string
    - `channels` string[]
    - `status` string — Always 'Idea' for ideas
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `linkedIn` object, nullable
      - `profile` ChannelProfile — Profile information for a channel (LinkedIn, X, or Instagram)
        - `id` string, uuid — Profile ID
        - `name` string, nullable — Profile name
        - `detail` string, nullable — Profile detail (vanity name for LinkedIn, @username for X)
      - `copy` string
      - `assets` Asset[] — Assets attached to the LinkedIn content
        - `id` string, uuid — Asset ID
        - `name` string — Original filename
        - `url` string, uri — URL to access the asset
        - `mimetype` string — MIME type of the file (e.g., image/jpeg, video/mp4)
        - `size` integer — File size in bytes
        - `width` integer, nullable — Width in pixels for images and videos
        - `height` integer, nullable — Height in pixels for images and videos
        - `duration` number, nullable — Duration in seconds for videos
    - `x` object, nullable — X (Twitter) content
      - `profile` ChannelProfile — Profile information for a channel (LinkedIn, X, or Instagram)
        - `id` string, uuid — Profile ID
        - `name` string, nullable — Profile name
        - `detail` string, nullable — Profile detail (vanity name for LinkedIn, @username for X)
      - `tweets` object[]
        - `copy` string
        - `assets` Asset[] — Assets attached to this tweet
          - `id` string, uuid — Asset ID
          - `name` string — Original filename
          - `url` string, uri — URL to access the asset
          - `mimetype` string — MIME type of the file (e.g., image/jpeg, video/mp4)
          - `size` integer — File size in bytes
          - `width` integer, nullable — Width in pixels for images and videos
          - `height` integer, nullable — Height in pixels for images and videos
          - `duration` number, nullable — Duration in seconds for videos
    - `tikTok` TikTokContent, nullable — TikTok content. Present when the post targets the TikTok channel.
      - `profile` ChannelProfile — Profile information for a channel (LinkedIn, X, or Instagram)
        - `id` string, uuid — Profile ID
        - `name` string, nullable — Profile name
        - `detail` string, nullable — Profile detail (vanity name for LinkedIn, @username for X)
      - `copy` string — Caption text
      - `assets` Asset[] — Assets attached to the TikTok post (one video).
        - `id` string, uuid — Asset ID
        - `name` string — Original filename
        - `url` string, uri — URL to access the asset
        - `mimetype` string — MIME type of the file (e.g., image/jpeg, video/mp4)
        - `size` integer — File size in bytes
        - `width` integer, nullable — Width in pixels for images and videos
        - `height` integer, nullable — Height in pixels for images and videos
        - `duration` number, nullable — Duration in seconds for videos
      - `privacyLevel` 'PUBLIC_TO_EVERYONE' | 'FOLLOWER_OF_CREATOR' | 'MUTUAL_FOLLOW_FRIENDS' | 'SELF_ONLY' — Audience visibility for the TikTok video.
      - `isCommentDisabled` boolean
      - `isDuetDisabled` boolean
      - `isStitchDisabled` boolean
      - `isPromotingBusiness` boolean
      - `isPaidPartnership` boolean
      - `videoCoverTimestampMs` integer, nullable — Timestamp (in milliseconds) of the video frame used as the cover thumbnail. Null when not set.
    - `youTubeShorts` YouTubeShortsContent, nullable — YouTube Shorts content. Present when the post targets the YouTube Shorts channel.
      - `profile` ChannelProfile — Profile information for a channel (LinkedIn, X, or Instagram)
        - `id` string, uuid — Profile ID
        - `name` string, nullable — Profile name
        - `detail` string, nullable — Profile detail (vanity name for LinkedIn, @username for X)
      - `title` string, nullable — Video title
      - `description` string, nullable — Video description
      - `assets` Asset[] — Assets attached to the YouTube Shorts post (one video).
        - `id` string, uuid — Asset ID
        - `name` string — Original filename
        - `url` string, uri — URL to access the asset
        - `mimetype` string — MIME type of the file (e.g., image/jpeg, video/mp4)
        - `size` integer — File size in bytes
        - `width` integer, nullable — Width in pixels for images and videos
        - `height` integer, nullable — Height in pixels for images and videos
        - `duration` number, nullable — Duration in seconds for videos
      - `privacyStatus` 'public' | 'private' | 'unlisted' — Audience visibility for the YouTube Shorts video.
      - `categoryId` string, nullable
      - `notifySubscribers` boolean
      - `isEmbeddable` boolean
      - `isSelfDeclaredMadeForKids` boolean

## Other responses

- `401` — Unauthorized - Missing or invalid API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/revisions/1d0792ff454f/schema)