openapi: 3.2.0
info:
  title: Quiet Stance Productive Opportunity Intake Inquiries API
  version: 3.2.3
  description: Submit a sanitized, permission-aware productive opportunity or qualified partner inquiry. Quiet Stance records the initial opportunity state before any optional partner handoff. Submission creates an intake record only; it does not create a mandate, exclusivity, non-circumvention, confidentiality, financing commitment or authority to act.
  contact:
    name: Quiet Stance
    email: david@quietstance.com
    url: https://quietstance.com/for-agents
  termsOfService: https://quietstance.com/terms
servers:
- url: https://quietstance.com
  description: Quiet Stance production public intake
tags:
- name: Inquiries
paths:
  /api/inquiries:
    post:
      operationId: submitProductiveOpportunity
      summary: Submit an authorized productive opportunity or qualified partner inquiry
      description: 'Priority use case: an owner, authority, host, sponsor or authorized originator with a bounded real project and a legitimate route to act. Qualified execution/capital partners may also register capability. Use only when the user is authorized to submit the information or an owner has explicitly invited participation. Do not send credentials, protected records, regulated personal data or confidential data-room material. Owner and authorized-originator submissions must include the owner/authority/host and the real economic use or demand.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - name
              - work_email
              - inquiry_type
              - project_name
              - country_location
              - opportunity_summary
              - rights_status
              - project_stage
              - consent
              properties:
                name:
                  type: string
                  maxLength: 160
                work_email:
                  type: string
                  format: email
                  maxLength: 320
                organization:
                  type: string
                  maxLength: 240
                inquiry_type:
                  type: string
                  enum:
                  - project_owner
                  - authorized_originator
                  - development_partner
                  - capital_partner
                  - other
                project_name:
                  type: string
                  maxLength: 220
                  description: Opportunity or project name.
                country_location:
                  type: string
                  maxLength: 220
                opportunity_summary:
                  type: string
                  maxLength: 3000
                  description: What productive outcome should exist, for whom, and why is it not happening already?
                owner_authority:
                  type: string
                  maxLength: 300
                  description: Required for project_owner and authorized_originator submissions. Identify the owner, authority, host, sponsor or procurement channel that can legitimately authorize action.
                rights_status:
                  type: string
                  enum:
                  - owner
                  - written_mandate
                  - open_procurement
                  - private_initiative
                  - site_or_host_permission
                  - permission_pending
                  - none
                project_stage:
                  type: string
                  maxLength: 2200
                  description: Current stage and primary execution blocker.
                demand_offtake:
                  type: string
                  maxLength: 2200
                  description: Required for project_owner and authorized_originator submissions. State the payer, user, off-take, tariff, operating spend, capacity demand or other real economic use.
                estimated_value:
                  type: string
                  maxLength: 120
                support_needed:
                  type: string
                  maxLength: 300
                notes:
                  type: string
                  maxLength: 1800
                source:
                  type: string
                  maxLength: 100
                consent:
                  const: true
              allOf:
              - if:
                  properties:
                    inquiry_type:
                      enum:
                      - project_owner
                      - authorized_originator
                  required:
                  - inquiry_type
                then:
                  required:
                  - owner_authority
                  - demand_offtake
            example:
              name: Example Project Lead
              work_email: lead@example.com
              organization: Example Manufacturing Ltd
              inquiry_type: project_owner
              project_name: Example factory energy opportunity
              country_location: Nigeria
              opportunity_summary: 'Example only: an operating factory has a measurable power-cost problem and wants to evaluate an authorized commercial-energy project.'
              owner_authority: Factory owner
              rights_status: owner
              project_stage: Initial commercial qualification before technical handoff.
              demand_offtake: Existing operating energy spend; exact load and commercial terms still require diligence.
              source: external-agent:example
              consent: true
      responses:
        '201':
          description: Opportunity received and recorded for review.
          content:
            application/json:
              schema:
                type: object
                required:
                - received
                - inquiry_id
                - status
                - control_recorded
                - control_state
                - disclosure_state
                - boundaries
                properties:
                  received:
                    type: string
      tags:
      - Inquiries