Every API here is available over the APIs.io API and to AI agents over MCP.
{"openapi":"3.1.0","info":{"title":"Lindo Unified API","version":"1.0.0","description":"Unified API for Lindo.ai - Includes workspace management, websites, pages, blogs, workflows, credits, and analytics"},"servers":[{"url":"https://api.lindo.ai","description":"Lindo API Server"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Client Management","description":"Manage workspace clients"},{"name":"Website Management","description":"Manage websites"},{"name":"Page Management","description":"Manage website pages"},{"name":"Blog Management","description":"Manage website blogs"},{"name":"Workspace Management","description":"Workspace settings and team management"},{"name":"Workflows","description":"AI workflow management"},{"name":"Credits","description":"Credit balance and usage"},{"name":"Analytics","description":"Website and workspace analytics"}],"paths":{"/v1/workspace/client/create":{"post":{"tags":["Client Management"],"summary":"Create new workspace client","description":"Creates a new client for a workspace with specified email and permissions","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientCreateRequest"}}}},"responses":{"200":{"description":"Client created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientCreateResponse"}}}},"400":{"description":"Bad request - validation error or client already exists","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/client/list":{"get":{"tags":["Client Management"],"summary":"List all workspace clients","description":"Retrieves a paginated list of all clients associated with the current workspace","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Page number for pagination","example":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"Search term to filter clients","example":"john"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"Client list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientListResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/client/update":{"put":{"tags":["Client Management"],"summary":"Update workspace client","description":"Updates an existing client's information including website limits and suspension status","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUpdateRequest"}}}},"responses":{"200":{"description":"Client updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientUpdateResponse"}}}},"400":{"description":"Bad request - validation error or update failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/client/delete":{"delete":{"tags":["Client Management"],"summary":"Delete workspace client","description":"Removes a client from the workspace and revokes their access","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientDeleteRequest"}}}},"responses":{"200":{"description":"Client deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientDeleteResponse"}}}},"400":{"description":"Bad request - client not found or deletion failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/client/magic-link":{"post":{"tags":["Authentication"],"summary":"Create magic link for workspace authentication","description":"Generates a magic link and verification code for passwordless authentication in a White Label workspace. The Embed Webapp add-on is not required.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkCreateRequest"}}}},"responses":{"200":{"description":"Magic link created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MagicLinkCreateResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"403":{"description":"Forbidden - user does not have access to this workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not found - workspace not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/list":{"get":{"tags":["Website Management"],"summary":"List all workspace websites","description":"Retrieves a paginated list of all websites associated with the current workspace","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Page number for pagination","example":"1"},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"Search term to filter websites","example":"example.com"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"Website list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteListResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/update":{"patch":{"tags":["Website Management"],"summary":"Update website information","description":"Updates website details using PATCH semantics. Undefined fields are not modified, null values clear the field. Supports business_name, business_description, custom_code_header, custom_code_footer, robots, language, and activated fields.","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePatchRequest"}}}},"responses":{"200":{"description":"Website updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsitePatchResponse"}}}},"400":{"description":"Bad request - validation error or update failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/delete":{"delete":{"tags":["Website Management"],"summary":"Delete website","description":"Permanently deletes a website and all associated data","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDeleteRequest"}}}},"responses":{"200":{"description":"Website deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDeleteResponse"}}}},"400":{"description":"Bad request - deletion failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/assign":{"post":{"tags":["Website Management"],"summary":"Assign website to client","description":"Assigns a website to a client","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteAssignRequest"}}}},"responses":{"200":{"description":"Website assigned to client successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteAssignResponse"}}}},"400":{"description":"Bad request - website or client not found in workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}":{"get":{"tags":["Website Management"],"summary":"Get website details","description":"Retrieves detailed information about a specific website including settings, integrations, and configuration.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"responses":{"200":{"description":"Website details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDetailsResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/settings":{"put":{"tags":["Website Management"],"summary":"Update website settings","description":"Updates website settings including business name, description, language, theme, and custom code.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Website settings updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSettingsUpdateResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/domain":{"post":{"tags":["Website Management"],"summary":"Add custom domain","description":"Initiates custom domain setup for a website. Returns agent-ready DNS records with instructions.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDomainAddRequest"}}}},"responses":{"200":{"description":"Custom domain setup initiated with DNS records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDomainAddResponse"}}}},"400":{"description":"Bad request - domain already in use or validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}},"delete":{"tags":["Website Management"],"summary":"Remove custom domain","description":"Removes the custom domain from a website, reverting to the default domain.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"responses":{"200":{"description":"Custom domain removed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteDomainRemoveResponse"}}}},"400":{"description":"Bad request - website has no custom domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/team":{"post":{"tags":["Website Management"],"summary":"Add team member","description":"Adds a team member to a website with Editor or Commenter role.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteTeamMemberAddRequest"}}}},"responses":{"200":{"description":"Team member added successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteTeamMemberAddResponse"}}}},"400":{"description":"Bad request - email already exists or validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}},"get":{"tags":["Website Management"],"summary":"Get website team list","description":"Retrieves a paginated list of website team members. Verifies website ownership before returning team list.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"}],"responses":{"200":{"description":"Website team list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamListResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/team/{member_id}":{"delete":{"tags":["Website Management"],"summary":"Remove team member","description":"Removes a team member from a website.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the team member","example":"member_abc123"},"required":true,"name":"member_id","in":"path"}],"responses":{"200":{"description":"Team member removed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteTeamMemberRemoveResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website or team member not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/analytics":{"get":{"tags":["Analytics"],"summary":"Get website analytics","description":"Retrieves analytics data for a specific website including traffic metrics, visitor counts, and performance data. Supports optional date range filtering.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Start date for analytics data (ISO timestamp)","example":"2024-01-01T00:00:00Z"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","description":"End date for analytics data (ISO timestamp)","example":"2024-01-31T23:59:59Z"},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"Website analytics retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteAnalyticsResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/analytics/ai-visibility":{"get":{"tags":["Analytics"],"summary":"Get website AI visibility analytics","description":"Retrieves AI-specific traffic analytics for a website: AI bot crawls, AI platform referrals, top cited pages, and a time series of both signals. Supports optional date range filtering.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"website_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Start date for analytics data (ISO timestamp)","example":"2024-01-01T00:00:00Z"},"required":false,"name":"from","in":"query"},{"schema":{"type":"string","description":"End date for analytics data (ISO timestamp)","example":"2024-01-31T23:59:59Z"},"required":false,"name":"to","in":"query"}],"responses":{"200":{"description":"AI visibility analytics retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteAiVisibilityResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/list":{"get":{"tags":["Page Management"],"summary":"List all website pages","description":"Retrieves a paginated list of all pages (template_type = 'Web Page') for a website. Supports search filtering by name or path.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":["number","null"],"default":1,"description":"Page number for pagination","example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"Search term to filter pages by name or path","example":"home"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"Page list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageListResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/{page_id}":{"get":{"tags":["Page Management"],"summary":"Get page details","description":"Retrieves detailed information about a specific page including SEO metadata, settings, and data fields.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"responses":{"200":{"description":"Page details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageDetailsResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}},"patch":{"tags":["Page Management"],"summary":"Update a page","description":"Updates a page using PATCH semantics. Accepts lang_code (e.g., 'en', 'es') for language and converts to display format for storage. Undefined fields are not modified, null clears the field.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageUpdateRequest"}}}},"responses":{"200":{"description":"Page updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageUpdateResponse"}}}},"400":{"description":"Bad request - validation error or invalid language code","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}},"delete":{"tags":["Page Management"],"summary":"Delete a page","description":"Permanently deletes a page. If the page was published, also removes the HTML file from storage and purges the cache.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"responses":{"200":{"description":"Page deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageDeleteResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/create":{"post":{"tags":["Page Management"],"summary":"Create a new page","description":"Creates a new page and publishes it with full HTML content. Parses HTML to extract title, SEO metadata, and custom codes.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCreateRequest"}}}},"responses":{"200":{"description":"Page created and published successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCreateResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/{page_id}/update":{"post":{"tags":["Page Management"],"summary":"Update a page","description":"Updates and publishes a page with full HTML content. Parses HTML to extract title, SEO metadata, and custom codes. Uses should_convert model for processing.","x-excluded":true,"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagePublishRequest"}}}},"responses":{"200":{"description":"Page updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagePublishResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/{page_id}/unpublish":{"post":{"tags":["Page Management"],"summary":"Unpublish a page","description":"Unpublishes a page by clearing the publish_date, removing it from public access.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"responses":{"200":{"description":"Page unpublished successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageUnpublishResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/pages/{page_id}/html":{"get":{"tags":["Page Management"],"summary":"Get page HTML for editing","description":"Returns the editable HTML content of a page. Used by CLI for live editing.","x-excluded":true,"security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":"string","description":"Unique identifier of the page","example":"page_abc123"},"required":true,"name":"page_id","in":"path"}],"responses":{"200":{"description":"Page HTML retrieved successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"result":{"type":"object","properties":{"page_id":{"type":"string"},"html":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"seo":{"type":"object","properties":{"page_title":{"type":"string"},"meta_description":{"type":"string"},"canonical_url":{"type":"string"}}},"settings":{"type":"object","properties":{"theme":{"type":"object","properties":{"mode":{"type":"string"},"direction":{"type":"string"},"main_classes":{"type":"string"}}}}}},"required":["page_id","html","path","name"]}},"required":["success","result"]}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Page not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/v1/workspace/website/{website_id}/blogs/list":{"get":{"tags":["Blog Management"],"summary":"List all website blogs","description":"Retrieves a paginated list of all blogs (template_type = 'Blog Post') for a website. Supports search filtering by name or path.","security":[{"bearerAuth":[]}],"parameters":[{"schema":{"type":"string","description":"Unique identifier of the website","example":"ws_abc123"},"required":true,"name":"website_id","in":"path"},{"schema":{"type":["number","null"],"default":1,"description":"Page number for pagination","example":1},"required":false,"name":"page","in":"query"},{"schema":{"type":"string","description":"Search term to filter blogs by name or path","example":"announcement"},"required":false,"name":"search","in":"query"}],"responses":{"200":{"description":"Blog list retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogListResponse"}}}},"400":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized - invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Website not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}
# --- truncated at 32 KB (169 KB total) ---
# Full source: https://artifacts.apis.io/lindo-ai/openapi/_original/lindo-ai-api-openapi.json