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

# Create prompt



## OpenAPI

````yaml /openapi.yaml post /domains/{domainId}/prompts
openapi: 3.1.0
info:
  title: Mentionpath API
  version: 1.0.0
  description: >
    Programmatic access to Mentionpath workspace data and actions.


    The REST API mirrors the MCP tool surface. Reads return immediately.
    Mutations may return

    `202` with `APPROVAL_REQUIRED` when invoked with a token that requires human
    approval.


    Base URL: `https://api.mentionpath.ai/api/v1`
servers:
  - url: https://api.mentionpath.ai/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Domains
  - name: Prompts
  - name: Audits
  - name: Competitors
  - name: Visibility
  - name: Mentions
  - name: Traffic
  - name: Webflow
  - name: Approvals
paths:
  /domains/{domainId}/prompts:
    post:
      tags:
        - Prompts
      summary: Create prompt
      operationId: createPrompt
      parameters:
        - $ref: '#/components/parameters/domainId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - title
              properties:
                title:
                  type: string
                locations:
                  type: string
                categoryType:
                  type: string
                  enum:
                    - commercial
                    - informational
                    - brand
                status:
                  type: string
                  enum:
                    - active
                    - archived
      responses:
        '200':
          description: Prompt created
        '202':
          description: Approval required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApprovalRequired'
components:
  parameters:
    domainId:
      name: domainId
      in: path
      required: true
      schema:
        type: string
        format: uuid
  schemas:
    ApprovalRequired:
      type: object
      required:
        - status
        - approvalRequestId
        - approvalUrl
      properties:
        status:
          type: string
          enum:
            - APPROVAL_REQUIRED
        approvalRequestId:
          type: string
          format: uuid
        approvalUrl:
          type: string
          format: uri
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API token or OAuth access token from Account → API in the Mentionpath
        app.

````