---
title: "Parse a gst-launch-1.0 pipeline string and extract elements and links."
method: POST
path: "/api/gst-launch/parse"
tags: ["gst-launch"]
---

# Parse a gst-launch-1.0 pipeline string and extract elements and links.

`POST /api/gst-launch/parse`

This uses GStreamer's native pipeline parser to ensure complete compatibility
with the gst-launch-1.0 syntax.

## Request body

- ParseGstLaunchRequest — Request to parse a gst-launch-1.0 pipeline string.
  - `pipeline` string, required — The gst-launch-1.0 pipeline string to parse Example: "videotestsrc pattern=ball ! videoconvert ! autovideosink"

## Response `200`

Pipeline parsed successfully

- ParseGstLaunchResponse — Response containing parsed pipeline elements and links.
  - `elements` Element[], required — Elements extracted from the parsed pipeline
    - `element_type` string, required — GStreamer element type (e.g., "videotestsrc", "x264enc", "filesink")
    - `id` string, required
    - `pad_properties` object — Pad properties (pad_name -> property_name -> value)
    - `position` number[], required — Display position in the visual editor (x, y)
    - `properties` object — Element properties as key-value pairs
  - `links` Link[], required — Links between elements
    - `from` string, required — Source element and pad (format: "element_id" or "element_id:pad_name")
    - `to` string, required — Destination element and pad (format: "element_id" or "element_id:pad_name")

## Other responses

- `400` — Invalid pipeline syntax

---

[API](https://skmtc.dev/eyevinn/apis/strom-api.md) · [All operations](https://skmtc.dev/eyevinn/apis/strom-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/eyevinn/strom-api/revisions/0df7ca64263f/schema)