{
  "info": {
    "_postman_id": "mattermesh-gs-api",
    "name": "MatterMesh — Gaussian Splatting API",
    "description": "REST endpoints for uploading captures and downloading Gaussian Splatting outputs (.splat / .ply) from MatterMesh's Reality Translation Engine. All authenticated routes accept the API key as `apikey`, `x-api-key`, or `Authorization: Bearer <key>`.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://matter-mesh.lovable.app" },
    { "key": "apiKey", "value": "mm_xxxxxxxx.yyyyyyyy" },
    { "key": "scanId", "value": "00000000-0000-0000-0000-000000000000" }
  ],
  "auth": {
    "type": "apikey",
    "apikey": [
      { "key": "key", "value": "apikey" },
      { "key": "value", "value": "{{apiKey}}" },
      { "key": "in", "value": "header" }
    ]
  },
  "item": [
    {
      "name": "Health probe",
      "request": {
        "method": "GET",
        "url": { "raw": "{{baseUrl}}/api/public/health", "host": ["{{baseUrl}}"], "path": ["api", "public", "health"] }
      }
    },
    {
      "name": "Upload a capture (agent)",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Content-Type", "value": "application/json" },
          { "key": "apikey", "value": "{{apiKey}}" }
        ],
        "url": {
          "raw": "{{baseUrl}}/api/public/agent-upload",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "agent-upload"]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agent_slug\": \"my-agent\",\n  \"image_url\": \"https://example.com/capture.jpg\",\n  \"metadata\": { \"note\": \"first upload\" }\n}"
        }
      }
    },
    {
      "name": "Splat job status",
      "request": {
        "method": "GET",
        "header": [{ "key": "apikey", "value": "{{apiKey}}" }],
        "url": {
          "raw": "{{baseUrl}}/api/public/ar/{{scanId}}",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "ar", "{{scanId}}"]
        }
      }
    },
    {
      "name": "Download .splat",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/api/public/file/{{scanId}}/splat",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "file", "{{scanId}}", "splat"]
        }
      }
    },
    {
      "name": "Download .ply",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/api/public/file/{{scanId}}/ply",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "file", "{{scanId}}", "ply"]
        }
      }
    },
    {
      "name": "Asset manifest",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/api/public/manifest/{{scanId}}",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "manifest", "{{scanId}}"]
        }
      }
    },
    {
      "name": "List recent public scans",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{baseUrl}}/api/public/library.index",
          "host": ["{{baseUrl}}"],
          "path": ["api", "public", "library.index"]
        }
      }
    }
  ]
}