> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate Pathway

> Create an asynchronous pathway generation job from a detailed prompt.

### 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.

```json Success theme={null}
{
  "data": {
    "jobId": "7a9e684f-6a50-4de5-bd95-9fa5f8121ddf"
  },
  "errors": null
}
```

```json Error theme={null}
{
  "data": null,
  "errors": [
    {
      "message": "PATHWAY_GENERATION_ERROR",
      "error": "Prompt must be greater than 100 characters."
    }
  ]
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.