---
title: "Generate Journey Steps Endpoint"
method: POST
path: "/v1/generate-journey-steps"
tags: ["Journey Steps"]
---

# Generate Journey Steps Endpoint

`POST /v1/generate-journey-steps`

Generate a draft of journey steps for an agent from a plain-language description.

## Headers

- `X-API-Key` string, required

## Request body

- GenerateJourneyStepsRequest
  - `agent_id` string, required — ID of the agent to generate journey steps for
  - `description` string, required — Plain-language description of the journey
  - `allow_sms` boolean — Whether the agent can send SMS
  - `max_steps` integer — Maximum number of steps to generate; clamped to 1-10

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/4ef94eeb836d/schema)