foxnose-net flux API

openapi: 3.1.0
info:
  title: foxnose-net flux API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 4 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; foxnose-net has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 5
    documentation: 17
    pages-with-code: 5
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://foxnose.net/docs/flux-api/v1/get-resource
  - https://foxnose.net/docs/flux-api/v1/get-started
  - https://foxnose.net/docs/flux-api/v1/mcp
  x-docs-section: flux-api
servers:
- url: https://api.foxnose.net
paths:
  /blog/_mcp:
    post:
      operationId: post_blog_mcp
      tags:
      - Blog
      summary: POST /blog/_mcp
      x-source: https://foxnose.net/docs/flux-api/v1/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostBlogMcpRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostBlogMcpResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -sS -i -X POST "https://7c9h4pwu.fxns.io/blog/_mcp"  -H "Authorization: Simple <public_key>:<private_key>"  -H "Content-Type:
          application/json"  -d ''{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}''  | awk -F '': '' ''tolower($1)=="mcp-session-id"
          {gsub(/\r/,"",$2); print $2}'') '
  /commerce/catalog/items/9d2hX6qPZmL0:
    get:
      operationId: get_commerce_catalog_items_9d2hX6qPZmL0
      tags:
      - Commerce
      summary: Returns a single resource from a collection mapped to your Flux API.
      x-source: https://foxnose.net/docs/flux-api/v1/get-resource
      parameters:
      - name: populate
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated list of reference fields to populate ( author,category.parent ). Maximum depth is three levels.
      - name: return_locales
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated locales to include. Defaults to every locale enabled in the environment.
      - name: fallback_locales
        in: query
        required: false
        schema:
          type: boolean
        description: When true, applies the environment’s fallback locale chain if a field is missing the requested translation.
      - name: raw
        in: query
        required: false
        schema:
          type: boolean
        description: Returns data exactly as stored (no locale processing or reference formatting). Use only when building low-level tooling.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCommerceCatalogItems9D2Hx6Qpzml0Response'
      x-evidence:
        kind: documentation
  /{apiPrefix}/_mcp:
    delete:
      operationId: delete_apiPrefix_mcp
      tags:
      - Mcp
      summary: DELETE /{api_prefix}/_mcp closes the session referenced by Mcp-Session-Id and always returns HTTP 204 (idempotent).
      x-source: https://foxnose.net/docs/flux-api/v1/mcp
      parameters:
      - name: apiPrefix
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /{prefix}/{collection}:
    get:
      operationId: get_prefix_collection
      tags:
      - Api
      summary: Lightweight listing with query-string filters.
      x-source: https://foxnose.net/docs/flux-api/v1/get-started
      parameters:
      - name: prefix
        in: path
        required: true
        schema:
          type: string
      - name: collection
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Number of results to return (1‑100).
      - name: populate
        in: query
        required: false
        schema:
          type: string
        description: Comma‑separated list of fields to populate.
      - name: where__field__operator
        in: query
        required: false
        schema:
          type: string
        description: Simple filter syntax.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
security:
- apiKey: []
components:
  schemas:
    PostBlogMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
    PostBlogMcpResponse:
      type: object
      properties:
        type:
          type: string
        text:
          type: string
    GetCommerceCatalogItems9D2Hx6Qpzml0Response:
      type: object
      properties:
        _sys:
          type: object
          description: System metadata about the resource.
        data:
          type: object
          description: Fields defined by the collection schema. Populated references contain nested _sys and data objects.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
tags:
- name: Api
- name: Blog
- name: Commerce
- name: Mcp