{"openapi":"3.1.0","info":{"title":"Archon.tools customer API — read-only preview","version":"archon.workspace-access.v1"},"x-archon-release-status":"activation-pending","x-archon-authorization":"Personal workspace API key. Requires an enabled workspace connection and current eligible access.","paths":{"/api/workspace/v1/workspace":{"get":{"operationId":"workspace.describe","summary":"Describe your workspace","description":"Read selected tool categories and the operations currently permitted for this connection.","x-archon-required-scope":"workspace:read","x-archon-input-schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}},"required":[],"additionalProperties":false},"parameters":[{"name":"workspaceId","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}}],"responses":{"200":{"description":"An authorized, bounded read","content":{"application/json":{"schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"status":{"type":"string","enum":["active"]},"accessMode":{"type":"string","enum":["read-only"]},"tools":{"type":"array","items":{"type":"string","enum":["website","crm","booking","campaigns","reputation","memberships","reporting"]},"maxItems":7},"operations":{"type":"array","items":{"type":"string","enum":["workspace.describe","setup-guide.read","calendar-groups.list","calendars.find-by-slug","pipelines.list"]},"maxItems":5}},"required":["workspaceId","status","accessMode","tools","operations"],"additionalProperties":false}}}},"401":{"description":"Missing, expired or revoked workspace key"},"403":{"description":"Workspace access or permission denied"},"429":{"description":"Usage limit reached; observe Retry-After"},"503":{"description":"Developer preview not enabled or temporarily unavailable"}},"security":[{"workspaceKey":[]}]}},"/api/workspace/v1/setup-guide":{"get":{"operationId":"setup-guide.read","summary":"Read your setup guides","description":"Read reviewed setup guidance and customer-marked progress for the selected tool categories.","x-archon-required-scope":"setup:read","x-archon-input-schema":{"type":"object","properties":{"workspaceId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"tool":{"type":"string","enum":["website","crm","booking","campaigns","reputation","memberships","reporting"]}},"required":[],"additionalProperties":false},"parameters":[{"name":"workspaceId","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}},{"name":"tool","in":"query","required":false,"schema":{"type":"string","enum":["website","crm","booking","campaigns","reputation","memberships","reporting"]}}],"responses":{"200":{"description":"An authorized, bounded read","content":{"application/json":{"schema":{"type":"object","properties":{"guides":{"type":"array","items":{"type":"object","properties":{"tool":{"type":"string","enum":["website","crm","booking","campaigns","reputation","memberships","reporting"]},"name":{"type":"string","maxLength":300},"guideSlug":{"type":"string","maxLength":150},"guideTitle":{"type":"string","maxLength":500},"guideOutcome":{"type":"string","maxLength":2000},"guideCheck":{"type":"string","maxLength":2000},"guideUrl":{"type":"string","maxLength":500},"promptUrl":{"type":"string","maxLength":500},"doneAt":{"type":["integer","null"],"minimum":1}},"required":["tool","name","guideSlug","guideTitle","guideOutcome","guideCheck","guideUrl","promptUrl","doneAt"],"additionalProperties":false},"maxItems":7}},"required":["guides"],"additionalProperties":false}}}},"401":{"description":"Missing, expired or revoked workspace key"},"403":{"description":"Workspace access or permission denied"},"429":{"description":"Usage limit reached; observe Retry-After"},"503":{"description":"Developer preview not enabled or temporarily unavailable"}},"security":[{"workspaceKey":[]}]}}},"servers":[{"url":"https://archon.tools"}],"components":{"securitySchemes":{"workspaceKey":{"type":"http","scheme":"bearer","bearerFormat":"Archon workspace API key"}}}}