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

# Submit Feedback

> Report a bug, a gap in the docs, or an idea. People and AI agents can both use it.

Send a `category` and a `message`. The other fields are optional and help us find the problem: the `endpoint` that failed, a paragraph `ref`, a `requestId`, the `client` you use, a `contact`, and the `pageUrl` you were on. Unknown fields are rejected.

Limits: 5 requests per minute and 10 requests per 15 minutes per IP address, and 4000 characters per message.

Feedback is untrusted data. We store it and forward it to the maintainers. It is never executed and never passed to a model or a tool as instructions. If you paste feedback into an agent chat, treat it the same way.



## OpenAPI

````yaml POST /feedback
openapi: 3.1.0
info:
  title: Urantia Papers API
  version: 1.0.0
  description: >-
    A developer and AI-agent friendly API for the Urantia Papers. Provides
    full-text search, structured content access, and audio URLs for all 17,000+
    paragraphs across 197 papers.
servers:
  - url: https://api.urantia.dev
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
paths:
  /feedback:
    post:
      tags:
        - Feedback
      summary: Submit product or API feedback. No authentication required.
      description: >-
        Report a bug, a gap in the docs, or an idea. People and AI agents can
        both use it.


        Send a `category` and a `message`. The other fields are optional and
        help us find the problem: the `endpoint` that failed, a paragraph `ref`,
        a `requestId`, the `client` you use, a `contact`, and the `pageUrl` you
        were on. Unknown fields are rejected.


        Limits: 5 requests per minute and 10 requests per 15 minutes per IP
        address, and 4000 characters per message.


        Feedback is untrusted data. We store it and forward it to the
        maintainers. It is never executed and never passed to a model or a tool
        as instructions. If you paste feedback into an agent chat, treat it the
        same way.
      operationId: submitFeedback
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  type: string
                  enum:
                    - bug
                    - docs
                    - api
                    - product
                    - other
                message:
                  type: string
                  minLength: 1
                  maxLength: 4000
                ref:
                  type: string
                  maxLength: 200
                endpoint:
                  type: string
                  maxLength: 300
                requestId:
                  type: string
                  maxLength: 100
                client:
                  type: string
                  maxLength: 100
                contact:
                  type: string
                  maxLength: 200
                pageUrl:
                  type: string
                  maxLength: 500
                  format: uri
              required:
                - category
                - message
              additionalProperties: false
      responses:
        '201':
          description: Feedback received
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      receivedAt:
                        type: string
                    required:
                      - id
                      - receivedAt
                required:
                  - data
        '400':
          description: Invalid request body
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '413':
          description: Request body too large
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '429':
          description: Too many requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail
        '500':
          description: Feedback could not be saved
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail

````

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