{
  "info": {
    "name": "Mintlify — mcp.ai",
    "description": "REST API for the Mintlify MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/mintlify",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "mintlify_create_agent_job",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/agent/job",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "agent",
            "job"
          ]
        },
        "description": "Start a background documentation agent job from a natural-language prompt. The agent edits the connected docs repo and OPENS A PULL REQUEST if it changes files (DESTRUCTIVE; consumes credits). Returns",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"prompt\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_agent_job",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/agent/job",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "agent",
            "job"
          ]
        },
        "description": "Retrieve the status and details (status, PR link, model, source repo/ref) of a docs agent job. Poll this until status is completed, archived or failed. No pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"job_id\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_assistant_caller_stats",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/assistant/caller/stats",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "assistant",
            "caller",
            "stats"
          ]
        },
        "description": "Get assistant query counts broken down by caller type (web, api, other, total) for a date range. Returns a single aggregate object; no pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_assistant_conversations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/assistant/conversations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "assistant",
            "conversations"
          ]
        },
        "description": "Export the AI assistant conversation history (question, answer, cited sources, resolution status) for a Mintlify project, optionally filtered by date. Returns one page of conversations plus a cursor t",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_feedback",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/feedback",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "feedback"
          ]
        },
        "description": "Export a project's user feedback (thumbs / contextual comments / agent feedback), optionally filtered by date, source and status. Returns one page plus a cursor to fetch the next.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"source\": \"\",\n  \"status\": \"\",\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_feedback_by_page",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/feedback/by/page",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "feedback",
            "by",
            "page"
          ]
        },
        "description": "Get feedback counts (thumbs up/down, code, total) aggregated per documentation page path for a date range. Single page of results — this endpoint exposes no pagination cursor, so only the first page i",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"source\": \"\",\n  \"status\": \"\",\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_page_views",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/page/views",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "page",
            "views"
          ]
        },
        "description": "Export per-path and site-wide content view counts split by human vs AI traffic. Offset-paginated: returns one page of rows plus site-wide totals, the hasMore flag as has_more, and a next_offset to fet",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_search_queries",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/search/queries",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "search",
            "queries"
          ]
        },
        "description": "Export documentation search terms ordered by hit count (with CTR and top clicked page). Returns one page plus a cursor to fetch the next; there is no more-flag, so stop paging once next_cursor is null",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_unique_visitors",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/unique/visitors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "unique",
            "visitors"
          ]
        },
        "description": "Export per-path and site-wide approximate distinct visitor counts split by human vs AI traffic. Offset-paginated: returns one page plus a `has_more` flag and the effective `next_offset` to fetch the f",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"offset\": 0,\n  \"date_to\": \"\",\n  \"date_from\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_get_update_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/update/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "update",
            "status"
          ]
        },
        "description": "Get the status and details (queued / in_progress / success / failure, logs, commit, screenshot) of a triggered deployment update by its statusId. Poll this with the statusId returned by MINTLIFY_TRIGG",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"status_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_send_agent_message",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/send/agent/message",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "send",
            "agent",
            "message"
          ]
        },
        "description": "Send a follow-up instruction to an existing, in-progress docs agent job (asynchronous). Use to refine or continue work on a job created by create_agent_job. Returns the updated AgentJob; poll get_agen",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"job_id\": \"\",\n  \"prompt\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_trigger_automation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/trigger/automation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "trigger",
            "automation"
          ]
        },
        "description": "Trigger a custom-schedule automation (workflow) to run immediately. Returns the schemaId, instanceId and jobId of the launched run. Only custom-schedule automations are triggerable (others return 400)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project_id\": \"\",\n  \"workflow_schema_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_trigger_preview",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/trigger/preview",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "trigger",
            "preview"
          ]
        },
        "description": "Create or update a preview deployment of the docs project for a Git branch (redeploys if a preview already exists for that branch). Returns a statusId to poll with MINTLIFY_GET_UPDATE_STATUS and a pre",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"branch\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "mintlify_trigger_update",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/trigger/update",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "trigger",
            "update"
          ]
        },
        "description": "Queue a production deployment of the docs project from its configured branch. Returns a statusId to poll with MINTLIFY_GET_UPDATE_STATUS. Requires a Mintlify plan that includes deployments (otherwise ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}