{"openapi":"3.1.0","info":{"title":"Virtual Colleague Public Information API","version":"1.0.0","description":"Read published Filipino virtual assistant and business outsourcing information. No authentication is required. All operations are read-only. Stable v1 endpoints use /api/v1/. Original unversioned URLs remain supported compatibility aliases.","contact":{"name":"Virtual Colleague","email":"hello@virtualcolleague.com.au","url":"https://virtualcolleague.com.au/contact-us/"}},"paths":{"/api/agent-search/":{"get":{"operationId":"searchPublishedPages","summary":"Search Virtual Colleague published pages","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Matching published pages","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"markdownUrl":{"type":"string"}}}}}}}}},"400":{"description":"Invalid query or result limit","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"description":"Supported compatibility alias; new integrations should use /api/v1/search/"}},"/api/agent-content/":{"get":{"operationId":"getPublishedPage","summary":"Read a published page as Markdown","parameters":[{"name":"path","in":"query","schema":{"type":"string","default":"/","example":"/virtual-assistant-roles/bookkeeping-va/"}}],"responses":{"200":{"description":"Published page Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Markdown error with recovery links","content":{"text/markdown":{"schema":{"type":"string"}}}}},"description":"Supported compatibility alias; new integrations should use /api/v1/pages/"}},"/api/agent-contact/":{"get":{"operationId":"getPublicContact","summary":"Read verified public contact details","responses":{"200":{"description":"Business name, email, telephone and city-level address","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"telephone":{"type":"string"},"address":{"type":"object","properties":{"@type":{"const":"PostalAddress"},"addressLocality":{"const":"Perth"},"addressRegion":{"const":"WA"},"addressCountry":{"const":"AU"}}},"url":{"type":"string","format":"uri"}}}}}}},"description":"Supported compatibility alias; new integrations should use /api/v1/contact/"}},"/api/v1/search/":{"get":{"operationId":"searchPublishedPagesV1","summary":"Search Virtual Colleague published pages","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Matching published pages","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"markdownUrl":{"type":"string"}}}}}}}}},"400":{"description":"Invalid query or result limit","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}},"description":"Stable version 1 public read-only operation."}},"/api/v1/pages/":{"get":{"operationId":"getPublishedPageV1","summary":"Read a published page as Markdown","parameters":[{"name":"path","in":"query","schema":{"type":"string","default":"/","example":"/virtual-assistant-roles/bookkeeping-va/"}}],"responses":{"200":{"description":"Published page Markdown","content":{"text/markdown":{"schema":{"type":"string"}}}},"404":{"description":"Markdown error with recovery links","content":{"text/markdown":{"schema":{"type":"string"}}}}},"description":"Stable version 1 public read-only operation."}},"/api/v1/contact/":{"get":{"operationId":"getPublicContactV1","summary":"Read verified public contact details","responses":{"200":{"description":"Business name, email, telephone and city-level address","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email"},"telephone":{"type":"string"},"address":{"type":"object","properties":{"@type":{"const":"PostalAddress"},"addressLocality":{"const":"Perth"},"addressRegion":{"const":"WA"},"addressCountry":{"const":"AU"}}},"url":{"type":"string","format":"uri"}}}}}}},"description":"Stable version 1 public read-only operation."}}},"components":{"schemas":{"ProblemDetails":{"type":"object","description":"RFC 9457 problem details for search validation errors.","required":["type","title","status","detail","code","resolution"],"properties":{"type":{"type":"string","format":"uri","const":"about:blank"},"title":{"type":"string","const":"Bad Request"},"status":{"type":"integer","const":400},"detail":{"type":"string"},"instance":{"type":"string","format":"uri-reference"},"code":{"type":"string","enum":["invalid_query","invalid_limit"]},"resolution":{"type":"string"},"error":{"type":"string","description":"Compatibility alias of detail."}}}}},"x-versioning-policy":{"strategy":"Major version in URL path: /api/v1/","currentVersion":"v1","breakingChanges":"Published under a new major version path.","deprecationNotice":"At least 90 days in developer documentation, with Deprecation, Sunset and Link headers when a specific operation is scheduled for retirement.","currentlyDeprecatedOperations":[]},"servers":[{"url":"https://virtualcolleague.com.au"}],"externalDocs":{"url":"https://virtualcolleague.com.au/developers/","description":"Virtual Colleague developer and agent reference"}}