> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

# Create Guidance

POST https://fai.buildwithfern.com/guidance/{domain}/create
Content-Type: application/json

Reference: https://buildwithfern.com/learn/docs/ai-features/ask-fern/api-reference/guidance/create-guidance

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://fai.buildwithfern.com` (Production, default)
- `https://fai-dev.buildwithfern.com` (Development)
- `http://localhost:8080` (Local)

## Request

### Path parameters

- `domain` (string, required)

### Body (application/json)

This endpoint expects a CreateGuidanceRequest.

- `context` (list of string, required) — The context of the guidance document, as a list of strings, that will be indexed. Each string will be vectorized separately to generate a separate record.
- `document` (string, required) — The content of the guidance document that will be returned to Ask Fern during Ask Fern retrieval.

## Response

### 200

Successful Response

- `guidance_id` (string, required) — The unique identifier of the created guidance document

## Errors

### 422 Unprocessable Entity Error

Validation Error

- `detail` (list of ValidationError, optional)

## Types

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### ValidationErrorLocItems

## Examples

**Request**

```json
{
  "context": [
    "string"
  ],
  "document": "string"
}
```

**Response**

```json
{
  "guidance_id": "string"
}
```