**Actionable comments posted: 8**

🧹 Nitpick comments (2)

api-reference/instagram/comments.mdx (1)
`3-3`: **Align openapi frontmatter format with repository guideline** The codebase systematically uses `openapi: "/api-reference/openapi/{spec}.json METHOD /path"` format across 113 API reference files, but the documented guideline specifies `openapi: 'METHOD /path'`. While Mintlify supports both formats and pages resolve correctly, this creates a discrepancy between the guideline and actual implementation. Either update the guideline to reflect the path-prefixed format or refactor files to follow the documented `METHOD /path` pattern for consistency.

🤖 Prompt for AI Agents
``` Verify each finding against the current code and only fix it if needed. In `@api-reference/instagram/comments.mdx` at line 3, The frontmatter uses the repository's path-prefixed format for the openapi key (openapi: "/api-reference/openapi/social.json GET /api/instagram/comments") but the guideline expects just the HTTP method and path; update the openapi frontmatter value to the canonical format "GET /api/instagram/comments" (i.e., remove the leading /api-reference/openapi/{spec}.json prefix) so the openapi key reads: openapi: 'GET /api/instagram/comments'. ```

api-reference/content/validate.mdx (1)
`3-3`: **Update repo guidance for API reference frontmatter format to include file path.** The format in line 3 is correct per Mintlify's official documentation (`openapi: " "`). However, the repo's coding guidelines state only `openapi: 'METHOD /path'`, which is incomplete and caused this discrepancy. Update the guideline to: `openapi: ' METHOD /path'` to align with Mintlify's supported format and prevent future confusion.

🤖 Prompt for AI Agents
``` Verify each finding against the current code and only fix it if needed. In `@api-reference/content/validate.mdx` at line 3, The repo guidance currently suggests using frontmatter like openapi: 'METHOD /path' which is incomplete; update the guidance and any examples to require the full Mintlify-supported format openapi: ' METHOD /path' so frontmatter entries (e.g., the openapi key in api-reference/content/validate.mdx) include the file path, METHOD, and path; change the guideline text, update example snippets to the new format, and run a quick repo-wide search for openapi frontmatter to correct any other occurrences. ```

🤖 Prompt for all review comments with AI agents

``` Verify each finding against the current code and only fix it if needed. Inline comments: In `@api-reference/content/generate-video.mdx`: - Line 3: The frontmatter key openapi in api-reference/content/generate-video.mdx currently includes the spec file path prefix; update the value to follow the repo convention by setting openapi to the HTTP method and path only (e.g., openapi: 'POST /api/content/video') so it matches the documented format used across the codebase. In `@api-reference/openapi/accounts.json`: - Around line 129-184: Add explicit OpenAPI security requirement objects to each authenticated operation (PATCH /api/accounts, GET /api/organizations, POST /api/workspaces, GET /api/pulses, PATCH /api/pulses, POST /api/notifications) so they are not treated as public; for each operation (e.g., the "patch" operation in accounts.json) add a "security" array referencing the already-declared authentication schemes used by the API (the x-api-key and/or Authorization Bearer scheme names defined in your components/securitySchemes) so code generators and tools know these endpoints require credentials and can surface 401/403 responses correctly. - Around line 1821-1835: The CreateAccountRequest schema currently allows an empty object; enforce the "at least one of email or wallet" rule by updating the CreateAccountRequest definition to include an anyOf constraint that requires either "email" or "wallet" (reference the schema name CreateAccountRequest and its properties "email" and "wallet"); add two anyOf branches each with a required array (one with ["email"], one with ["wallet"]) so generated clients and the playground will reject {} while keeping existing property definitions intact. - Around line 1494-1510: The OpenAPI 3.1 schema uses deprecated `nullable: true` entries (e.g., properties "image", "instruction", "knowledges") which must be converted to JSON Schema style nullable type arrays; for each property currently using `nullable: true` (15 occurrences total) replace the `type: "X", "nullable": true` pattern with `type: ["X","null"]` (e.g., `type: ["string","null"]` for "image"/"instruction" and `type: ["array","null"]` for "knowledges"), ensuring any `items` refs remain intact and no other schema keywords are removed. In `@api-reference/openapi/social.json`: - Around line 930-1099: The GET/POST/DELETE operations under the "/api/connectors" path are missing operation-level security declarations; add a security array to each operation (get, post, delete) referencing the existing schemes (e.g., bearerAuth and/or apiKeyAuth) so these endpoints are not treated as public—for each operation add "security": [{"bearerAuth": []}, {"apiKeyAuth": []}] (or the appropriate scheme combination) to enforce authentication. - Around line 1127-1131: The OpenAPI 3.1 spec in social.json still uses "nullable": true (e.g., the "error" property shown) which is invalid; locate every property object containing "nullable": true (including the listed instances) and remove "nullable": true, then replace or update the property's "type" to the JSON-Schema union form by adding "null" (for example change a string type to "type": ["string","null"] or an object/array/number type to include null). Ensure you update each occurrence consistently (search for "nullable": true), preserving existing type information in the property's schema (for properties with no explicit "type", add the appropriate union type including "null"). In `@api-reference/research/playlist.mdx`: - Around line 1-4: The repo has mixed OpenAPI frontmatter formats (new style like openapi: "/api-reference/openapi/research.json GET /api/research/playlist" in playlist.mdx vs legacy "post /path" entries); scan all api-reference MDX files for the old pattern (e.g., strings like "post /", "get /" used in frontmatter) and either (A) convert them to the new frontmatter format matching playlist.mdx (compose openapi value as " ") or (B) confirm with Mintlify/maintainers that the legacy format is supported and document that decision; update all affected files consistently and run the docs build to verify the "Try it" playground and rendering work. In `@api-reference/sandboxes/snapshot.mdx`: - Around line 1-4: Update the OpenAPI frontmatter in snapshot.mdx by removing the spec file path prefix so the openapi field contains only the method and path; change the existing openapi value that currently reads "/api-reference/openapi/content.json PATCH /api/sandboxes" to the short form "PATCH /api/sandboxes" in the frontmatter block so it conforms to the API reference guidelines. --- Nitpick comments: In `@api-reference/content/validate.mdx`: - Line 3: The repo guidance currently suggests using frontmatter like openapi: 'METHOD /path' which is incomplete; update the guidance and any examples to require the full Mintlify-supported format openapi: ' METHOD /path' so frontmatter entries (e.g., the openapi key in api-reference/content/validate.mdx) include the file path, METHOD, and path; change the guideline text, update example snippets to the new format, and run a quick repo-wide search for openapi frontmatter to correct any other occurrences. In `@api-reference/instagram/comments.mdx`: - Line 3: The frontmatter uses the repository's path-prefixed format for the openapi key (openapi: "/api-reference/openapi/social.json GET /api/instagram/comments") but the guideline expects just the HTTP method and path; update the openapi frontmatter value to the canonical format "GET /api/instagram/comments" (i.e., remove the leading /api-reference/openapi/{spec}.json prefix) so the openapi key reads: openapi: 'GET /api/instagram/comments'. ```

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR: - [ ] Push a commit to this branch (recommended) - [ ] Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

**Configuration used**: defaults **Review profile**: CHILL **Plan**: Pro **Run ID**: `8bcce0a5-22a0-45b1-919d-a79ce0b2a050`

📥 Commits

Reviewing files that changed from the base of the PR and between 097a526230e17a9d43ac70a0c43063bb82355f59 and c597bcd5939a0ea6897540ac0ee325719be5654d.

📒 Files selected for processing (119)

* `api-reference/accounts/add-artist.mdx` * `api-reference/accounts/create.mdx` * `api-reference/accounts/get.mdx` * `api-reference/accounts/id.mdx` * `api-reference/accounts/update.mdx` * `api-reference/admins/check.mdx` * `api-reference/admins/coding-agent-slack-tags.mdx` * `api-reference/admins/coding-pr.mdx` * `api-reference/admins/content-slack-tags.mdx` * `api-reference/admins/emails.mdx` * `api-reference/admins/privy.mdx` * `api-reference/admins/sandboxes-orgs.mdx` * `api-reference/admins/sandboxes.mdx` * `api-reference/apify/scraper.mdx` * `api-reference/artist/profile.mdx` * `api-reference/artist/segments.mdx` * `api-reference/artist/socials.mdx` * `api-reference/artists/create.mdx` * `api-reference/artists/list.mdx` * `api-reference/chat/artist.mdx` * `api-reference/chat/chats.mdx` * `api-reference/chat/compact.mdx` * `api-reference/chat/messages-copy.mdx` * `api-reference/chat/messages-trailing-delete.mdx` * `api-reference/chat/messages.mdx` * `api-reference/chat/segment.mdx` * `api-reference/comments/get.mdx` * `api-reference/connectors/authorize.mdx` * `api-reference/connectors/disconnect.mdx` * `api-reference/connectors/list.mdx` * `api-reference/content-agent/callback.mdx` * `api-reference/content-agent/webhook.mdx` * `api-reference/content/analyze-video.mdx` * `api-reference/content/create.mdx` * `api-reference/content/edit.mdx` * `api-reference/content/estimate.mdx` * `api-reference/content/generate-caption.mdx` * `api-reference/content/generate-image.mdx` * `api-reference/content/generate-video.mdx` * `api-reference/content/template-detail.mdx` * `api-reference/content/templates.mdx` * `api-reference/content/transcribe-audio.mdx` * `api-reference/content/upscale.mdx` * `api-reference/content/validate.mdx` * `api-reference/fans/get.mdx` * `api-reference/image/generation.mdx` * `api-reference/instagram/comments.mdx` * `api-reference/instagram/profiles.mdx` * `api-reference/notifications/create.mdx` * `api-reference/openapi.json` * `api-reference/openapi/accounts.json` * `api-reference/openapi/content.json` * `api-reference/openapi/releases.json` * `api-reference/openapi/research.json` * `api-reference/openapi/social.json` * `api-reference/organizations/add-artist.mdx` * `api-reference/organizations/create.mdx` * `api-reference/organizations/list.mdx` * `api-reference/post/comments.mdx` * `api-reference/posts/get.mdx` * `api-reference/pulses/list.mdx` * `api-reference/pulses/update.mdx` * `api-reference/research/albums.mdx` * `api-reference/research/audience.mdx` * `api-reference/research/career.mdx` * `api-reference/research/charts.mdx` * `api-reference/research/cities.mdx` * `api-reference/research/curator.mdx` * `api-reference/research/deep.mdx` * `api-reference/research/discover.mdx` * `api-reference/research/enrich.mdx` * `api-reference/research/extract.mdx` * `api-reference/research/festivals.mdx` * `api-reference/research/genres.mdx` * `api-reference/research/insights.mdx` * `api-reference/research/instagram-posts.mdx` * `api-reference/research/lookup.mdx` * `api-reference/research/metrics.mdx` * `api-reference/research/milestones.mdx` * `api-reference/research/people.mdx` * `api-reference/research/playlist.mdx` * `api-reference/research/playlists.mdx` * `api-reference/research/profile.mdx` * `api-reference/research/radio.mdx` * `api-reference/research/rank.mdx` * `api-reference/research/search.mdx` * `api-reference/research/similar.mdx` * `api-reference/research/track.mdx` * `api-reference/research/tracks.mdx` * `api-reference/research/urls.mdx` * `api-reference/research/venues.mdx` * `api-reference/research/web.mdx` * `api-reference/sandboxes/create.mdx` * `api-reference/sandboxes/delete.mdx` * `api-reference/sandboxes/file.mdx` * `api-reference/sandboxes/list.mdx` * `api-reference/sandboxes/setup.mdx` * `api-reference/sandboxes/snapshot.mdx` * `api-reference/sandboxes/upload.mdx` * `api-reference/segment/fans.mdx` * `api-reference/social/posts.mdx` * `api-reference/social/scrape.mdx` * `api-reference/songs/analyze-presets.mdx` * `api-reference/songs/analyze.mdx` * `api-reference/spotify/album.mdx` * `api-reference/spotify/artist-albums.mdx` * `api-reference/spotify/artist-top-tracks.mdx` * `api-reference/spotify/artist.mdx` * `api-reference/spotify/search.mdx` * `api-reference/subscriptions/get.mdx` * `api-reference/tasks/create.mdx` * `api-reference/tasks/delete.mdx` * `api-reference/tasks/get.mdx` * `api-reference/tasks/runs.mdx` * `api-reference/tasks/update.mdx` * `api-reference/transcribe/audio.mdx` * `api-reference/workspaces/create.mdx` * `api-reference/x/search.mdx` * `api-reference/x/trends.mdx`