v2 - Launches

List Launches

List launches with optional filters.

Filter by workspace, content, or status.

Access: Must have CONTENT_VIEW permission on the workspace/content.

get/v2/launches

Request

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

Query parameters

workspace_idstring nullable

Filter by workspace

content_idstring nullable

Filter by content

statusstring nullable

Filter by status

limitinteger
offsetinteger

Headers

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

Response

Successful Response

totalinteger required

Total count (for pagination)

limitinteger required

Requested limit

offsetinteger required

Requested offset

published_totalinteger

Launches in the same scope that are not handovers (Send to editor) and not ads only (a Meta ad created paused is not a publish), ignoring the status filter and the page. Answers 'has anything gone out' without reading every page.

Example response

{
  "launches": [
    {
      "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.