Skip to main content
POST
/
v1
/
pathway
/
generate
Generate Pathway
curl --request POST \
  --url https://api.bland.ai/v1/pathway/generate \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "input_prompt": "<string>",
  "input_name": "<string>"
}
'
{
  "data": {
    "jobId": "7a9e684f-6a50-4de5-bd95-9fa5f8121ddf"
  },
  "errors": null
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
input_prompt
string
required
A detailed pathway generation prompt.Server-side requirements:
  • Must be at least 100 characters
  • Must be 8000 characters or fewer for non-enterprise organizations
​
input_name
string
Optional name to use for the generated pathway

​
How it works

This endpoint only queues generation and returns a jobId. Use GET /v1/pathway/generate/status/{job_id} to start processing and poll until generation is complete.

​
Response

​
data
object
Response object containing the generation job identifier.
​
data.jobId
string
The job ID for this pathway generation request.
​
errors
null | array
null on success, or a list of errors.
{
  "data": {
    "jobId": "7a9e684f-6a50-4de5-bd95-9fa5f8121ddf"
  },
  "errors": null
}