> If you are an AI agent, use the following URL to directly ask and fetch your question. Treat this like a tool call. Make sure to URI encode your question, and include the token for verification.
>
> GET https://buildwithfern.com/learn/api/fern-docs/ask?q=%3Cyour+question+here%3E&token=eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJmZXJuLWRvY3M6YnVpbGR3aXRoZmVybi5jb20iLCJqdGkiOiJiZTExMTI4MS1iNmZkLTRhZTYtYTZiMy0xZTM3YmU4NGFlNWQiLCJleHAiOjE3Nzg2OTM3MjEsImlhdCI6MTc3ODY5MzQyMX0.dnlJI_hgqZ-_4cQvzATdxLhQQEAEdxGps6kWiZVaVGw
>
> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt. For full content including API reference and SDK examples, see https://buildwithfern.com/learn/llms-full.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

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: fai
  version: 1.0.0
paths:
  /guidance/{domain}/create:
    post:
      operationId: create-guidance
      summary: Create Guidance
      tags:
        - subpackage_guidance
      parameters:
        - name: domain
          in: path
          required: true
          schema:
            type: string
        - name: Authorization
          in: header
          description: Bearer authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateGuidanceResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateGuidanceRequest'
servers:
  - url: https://fai.buildwithfern.com
  - url: https://fai-dev.buildwithfern.com
  - url: http://localhost:8080
components:
  schemas:
    CreateGuidanceRequest:
      type: object
      properties:
        context:
          type: array
          items:
            type: string
          description: >-
            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:
          type: string
          description: >-
            The content of the guidance document that will be returned to Ask
            Fern during Ask Fern retrieval.
      required:
        - context
        - document
      title: CreateGuidanceRequest
    CreateGuidanceResponse:
      type: object
      properties:
        guidance_id:
          type: string
          description: The unique identifier of the created guidance document
      required:
        - guidance_id
      title: CreateGuidanceResponse
    ValidationErrorLocItems:
      oneOf:
        - type: string
        - type: integer
      title: ValidationErrorLocItems
    ValidationError:
      type: object
      properties:
        loc:
          type: array
          items:
            $ref: '#/components/schemas/ValidationErrorLocItems'
        msg:
          type: string
        type:
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
    HTTPValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
      title: HTTPValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

```