JUjubjubapp
v2 - Launches

Get Launch

Get details of a specific launch including history.

Access: Must have CONTENT_VIEW permission on the launch's workspace.

get/v2/launches/{launch_id}

Request

  • Base URL
    https://api.jubjubapp.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

launch_idstring required

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Response

Successful Response

launch_idstring required

Unique launch identifier

content_idstring required

ID of the content being published

content_titlestring nullable

Title of the content

content_thumbnail_urlstring nullable

Thumbnail URL of the content

workspace_idstring required

Workspace ID

created_bystring nullable

Creator's profile ID: only the caller's own (or for a platform admin)

created_by_youboolean

Whether the caller created this launch

statusstring required

Overall status: pending, awaiting_approval, scheduled, in_progress, completed, partial_failure, failed, cancelled, handed_over (sent to the creator's own editor to post; JubJub published nothing), unknown (stored value unrecognised; never executed)

error_codestring nullable

Why the launch as a whole is waiting or stopped: AWAITING_OWNER_APPROVAL (a shared account's owner must approve), AWAITING_WORKSPACE_APPROVAL (the workspace owner must release it), APPROVAL_REJECTED, MEMBER_REMOVED (cancelled: its launcher left the team), or the one code every failed platform shares. Null otherwise.

scheduled_forstring date-time nullable

Scheduled publish time

timezonestring nullable

Timezone for scheduled_for

platform_schedulesobject nullable

Per-platform schedule overrides keyed by config_id

platform_overridesobject nullable

Per-platform settings overrides keyed by config_id

first_commentstring nullable

General first comment for this launch (per-platform ones win)

first_comment_noticestring nullable

Where the general first comment is NOT being posted, and why, in one line (e.g. 'Instagram first comments are coming soon, so this one was not posted on Instagram.'). Null when it goes everywhere it was sent. Tell the user: the launch still publishes, only the comment stops.

created_atstring date-time required

When launch was created

updated_atstring date-time nullable

Last update time

completed_atstring date-time nullable

When launch completed

sent_to_ad_library_countinteger

Legs sent to a Meta ad account's media library (not published; not in successful_count)

noticesstring[]

Plain sentences about this request, e.g. that Meta Ads campaign settings were ignored

total_platformsinteger required

Total number of platforms

successful_countinteger required

Number of successful platforms

failed_countinteger required

Number of failed platforms

sent_nowboolean

Example response

{
  "completed_at": "2024-01-17T10:02:00Z",
  "content_id": "cnt_xyz789",
  "created_at": "2024-01-17T10:00:00Z",
  "created_by_you": true,
  "creator": {
    "display_name": "Ada",
    "handle": "ada",
    "is_you": true
  },
  "failed_count": 1,
  "launch_id": "lch_abc123",
  "platforms": [
    {
      "completed_at": "2024-01-17T10:02:00Z",
      "config_id": "cfg_001",
      "platform": "instagram",
      "published_id": "123456789",
      "published_url": "https://instagram.com/reel/abc123",
      "started_at": "2024-01-17T10:00:00Z",
      "status": "success"
    },
    {
      "completed_at": "2024-01-17T10:00:05Z",
      "config_id": "cfg_002",
      "error": "Invalid credentials",
      "platform": "youtube",
      "started_at": "2024-01-17T10:00:00Z",
      "status": "failed"
    }
  ],
  "status": "partial_failure",
  "successful_count": 1,
  "total_platforms": 2,
  "workspace_id": "ws_def456"
}

Changes

No recorded changes to this operation across all 1 revision of this API.