---
title: "Link existing steps"
method: POST
path: "/guide/step/link"
tags: ["guide"]
---

# Link existing steps

`POST /guide/step/link`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/guide/step/link`
- Auth: HTTP basic

Connects two existing steps with a navigation transition.

## Query parameters

- `teamId` integer

## Request body

- LinkSteps
  - `guideId` string, required: Unique guide ID (public identifier)
  - `sourceStepId` integer, required: ID of the source step from which the link will be created. Cannot be END_OF_GUIDE (-1), INTRODUCTION_TO_GUIDE (-2), EXTERNAL_LINK_FROM_GUIDE (-3), STEP_AD (-4), STEP_WIDGET_ACTION (-5), or STEP_AI_ACTION (-6)
  - `targetStepId` integer, required: ID of the target step to which the link will point
  - `choiceLabel` string: Label for the navigation button to the target step in the guide's default language (optional)
  - `position` integer: Position index for inserting the link among existing next steps (optional, defaults to end)

## Response `201`

Steps successfully linked.

- object
  - `success` boolean: Indicates successful link creation.

## Other responses

- `default`: Standard error response.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)