{ "openapi": "3.1.0", "info": { "title": "SalesDrone by AvinyaTech API", "version": "1.29.0", "description": "Part of Avinya Enterprises. Versioned REST API supporting GET, POST, PUT, PATCH and DELETE. Data operations accept expiring scoped Personal Access Tokens (Authorization: Bearer), or Firebase Google ID token plus App Check. Administration, token management, identity, device management and AI-generation endpoints require Google sign-in and App Check. Tokens inherit the active admin owner’s current capabilities and assigned/all lead scope; revoked or expired tokens fail authorization. Writes may require expectedVersion and Idempotency-Key as documented. Individual lead removal uses archive. The separate Google/Admin-only lead-data reset permanently clears lead data while retaining users and configuration. All responses are no-store; paginate until nextCursor is null. Demo identities cannot read live data." }, "servers": [ { "url": "/" } ], "paths": { "/api/v1/me": { "patch": { "operationId": "patch_me", "summary": "PATCH /me", "description": "Requires: Active workspace membership. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "me" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Preferences" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Preferences" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } }, "get": { "operationId": "get_me", "summary": "GET /me", "description": "Requires: Google sign-in. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "me" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Profile" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/personal-access-tokens": { "get": { "operationId": "get_personal_access_tokens", "summary": "GET /personal-access-tokens", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "personal-access-tokens" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenPage" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_personal_access_tokens", "summary": "POST /personal-access-tokens", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Admin-only. Do not send Idempotency-Key. Token is shown once; list and delete metadata never include the credential or its hash. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "personal-access-tokens" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenCreated" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenInput" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/personal-access-tokens/{id}": { "delete": { "operationId": "delete_personal_access_tokens__id", "summary": "DELETE /personal-access-tokens/:id", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "personal-access-tokens" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/workspace-settings": { "get": { "operationId": "get_workspace_settings", "summary": "GET /workspace-settings", "description": "Requires: leads:read. Personal access token scope: configuration:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. PATCH requires Admin role and members:write. assignedOnly defaults true and caps non-admin scope; false restores each member’s configured scope. exportsEnabled defaults true. Reads are allowed to active workspace members.", "tags": [ "workspace-settings" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "configuration:read", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceSettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_workspace_settings", "summary": "PATCH /workspace-settings", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. PATCH requires Admin role and members:write. assignedOnly defaults true and caps non-admin scope; false restores each member’s configured scope. exportsEnabled defaults true. Reads are allowed to active workspace members. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "workspace-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceSettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkspaceSettingsPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/leads/export": { "post": { "operationId": "post_leads_export", "summary": "POST /leads/export", "description": "Requires: leads:read. Personal access token scope: leads:export. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Paged report data, not a binary file. Export must be enabled. Uses all supplied lead filters; selected available columns only. Follow nextCursor, including sparse pages, until null. Cursors bind filters, column order, field configuration and workspace policy. Audit records contain counts only. Maximum 120 pages per user per minute. Rows reflect current values while paging, not a transactional snapshot.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:export", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadExportPage" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadExportInput" } } } } } }, "/api/v1/ai-settings": { "get": { "operationId": "get_ai_settings", "summary": "GET /ai-settings", "description": "Requires: members:write. Admin-only workspace AI preferences; blank instructions restore defaults. Changes invalidate summary caches and stale generation cannot publish. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "ai-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AISettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_ai_settings", "summary": "PATCH /ai-settings", "description": "Requires: members:write. Admin-only workspace AI preferences; blank instructions restore defaults. Changes invalidate summary caches and stale generation cannot publish. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "ai-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AISettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AISettingsPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/field-options": { "get": { "operationId": "get_field_options", "summary": "GET /field-options", "description": "Requires: leads:read. Personal access token scope: configuration:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "field-options" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "configuration:read", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FieldOptions" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_field_options", "summary": "PATCH /field-options", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "field-options" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FieldOptions" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FieldOptionsPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/lead-research-settings": { "get": { "operationId": "get_lead_research_settings", "summary": "GET /lead-research-settings", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-research-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchSettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_lead_research_settings", "summary": "PATCH /lead-research-settings", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "lead-research-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchSettings" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchSettingsPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/lead-hygiene/scans": { "post": { "operationId": "post_lead_hygiene_scans", "summary": "POST /lead-hygiene/scans", "description": "Requires: hygiene:run. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchScan" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScanInput" } } } } }, "get": { "operationId": "get_lead_hygiene_scans", "summary": "GET /lead-hygiene/scans", "description": "Requires: hygiene:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchScan" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-hygiene/scans/{id}": { "get": { "operationId": "get_lead_hygiene_scans__id", "summary": "GET /lead-hygiene/scans/:id", "description": "Requires: hygiene:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchScan" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "delete": { "operationId": "delete_lead_hygiene_scans__id", "summary": "DELETE /lead-hygiene/scans/:id", "description": "Requires: hygiene:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchVersion" } } } } } }, "/api/v1/lead-hygiene/scans/{id}/findings": { "get": { "operationId": "get_lead_hygiene_scans__id_findings", "summary": "GET /lead-hygiene/scans/:id/findings", "description": "Requires: hygiene:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchFinding" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-hygiene/scans/{id}/findings/{findingId}/leads": { "get": { "operationId": "get_lead_hygiene_scans__id_findings__findingId_leads", "summary": "GET /lead-hygiene/scans/:id/findings/:findingId/leads", "description": "Requires: hygiene:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "findingId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchLead" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-hygiene/scans/{id}/summary": { "post": { "operationId": "post_lead_hygiene_scans__id_summary", "summary": "POST /lead-hygiene/scans/:id/summary", "description": "Requires: hygiene:ai. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-hygiene" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchScan" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchVersion" } } } } } }, "/api/v1/lead-assistant/index": { "get": { "operationId": "get_lead_assistant_index", "summary": "GET /lead-assistant/index", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchIndex" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_lead_assistant_index", "summary": "POST /lead-assistant/index", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchIndex" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationInput" } } } } } }, "/api/v1/lead-assistant/conversations": { "post": { "operationId": "post_lead_assistant_conversations", "summary": "POST /lead-assistant/conversations", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssistantConversation" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationInput" } } } } }, "get": { "operationId": "get_lead_assistant_conversations", "summary": "GET /lead-assistant/conversations", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AssistantConversation" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-assistant/conversations/{id}/messages": { "get": { "operationId": "get_lead_assistant_conversations__id_messages", "summary": "GET /lead-assistant/conversations/:id/messages", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/AssistantRequest" } }, "nextCursor": { "type": [ "string", "null" ] }, "conversation": { "$ref": "#/components/schemas/AssistantConversation" } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-assistant/conversations/{id}/questions": { "post": { "operationId": "post_lead_assistant_conversations__id_questions", "summary": "POST /lead-assistant/conversations/:id/questions", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssistantRequest" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionInput" } } } } } }, "/api/v1/lead-assistant/requests/{id}": { "get": { "operationId": "get_lead_assistant_requests__id", "summary": "GET /lead-assistant/requests/:id", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssistantRequest" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-assistant/requests/{id}/leads": { "get": { "operationId": "get_lead_assistant_requests__id_leads", "summary": "GET /lead-assistant/requests/:id/leads", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "part", "schema": { "type": "integer", "minimum": 0, "maximum": 3, "default": 0 }, "description": "Zero-based answer part. The signed cursor is bound to this result set; a different part cannot reuse it." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "company": { "type": "string" }, "stage": { "type": "string" }, "detail": { "type": "string" }, "href": { "type": "string", "description": "Server-owned app detail path for the authorized source record." } } } }, "nextCursor": { "type": [ "string", "null" ] } } } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/lead-assistant/requests/{id}/cancel": { "post": { "operationId": "post_lead_assistant_requests__id_cancel", "summary": "POST /lead-assistant/requests/:id/cancel", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssistantRequest" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "expectedVersion" ], "additionalProperties": false, "properties": { "expectedVersion": { "type": "integer", "minimum": 1 } } } } } } } }, "/api/v1/lead-assistant/conversations/{id}": { "delete": { "operationId": "delete_lead_assistant_conversations__id", "summary": "DELETE /lead-assistant/conversations/:id", "description": "Requires: assistant:query. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Lead research is read-only for leads. Admins receive feature access by default; members need explicit grants intersecting current lead scope. Histories are creator-private and retained until deletion. Source/policy changes invalidate results. Reports are resumable and full-list; archive candidates require explicit settings. Assistant counts are deterministic; calendar-month conversions count distinct accessible active leads with recorded transitions into configured converted stages. Missing import history is explicitly partial. Qualitative answers use bounded source-verified RAG, never top-k counting. Indexing is disabled by default and must be enabled by an Admin. No PAT, lead mutation or arbitrary query execution.", "tags": [ "lead-assistant" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResearchVersion" } } } } } }, "/api/v1/lead-data-reset": { "get": { "operationId": "get_lead_data_reset", "summary": "GET /lead-data-reset", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Google/App Check Admin-only; PAT denied. Clear all active/archived leads and related data, retain users/configuration and standalone reminders. Preview expires after ten minutes; confirmation includes concurrent additions. Cleanup waits five minutes then runs in bounded resumable batches; lead mutations return LEAD_DATA_RESET (503) while active/blocked. Old idempotency receipts are redacted and return RESET_REQUEST_EXPIRED (409). No cancel after acceptance.", "tags": [ "lead-data-reset" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetStatus" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_lead_data_reset", "summary": "POST /lead-data-reset", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Google/App Check Admin-only; PAT denied. Clear all active/archived leads and related data, retain users/configuration and standalone reminders. Preview expires after ten minutes; confirmation includes concurrent additions. Cleanup waits five minutes then runs in bounded resumable batches; lead mutations return LEAD_DATA_RESET (503) while active/blocked. Old idempotency receipts are redacted and return RESET_REQUEST_EXPIRED (409). No cancel after acceptance.", "tags": [ "lead-data-reset" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetConfirmation" } } } } } }, "/api/v1/lead-data-reset/preview": { "post": { "operationId": "post_lead_data_reset_preview", "summary": "POST /lead-data-reset/preview", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Google/App Check Admin-only; PAT denied. Clear all active/archived leads and related data, retain users/configuration and standalone reminders. Preview expires after ten minutes; confirmation includes concurrent additions. Cleanup waits five minutes then runs in bounded resumable batches; lead mutations return LEAD_DATA_RESET (503) while active/blocked. Old idempotency receipts are redacted and return RESET_REQUEST_EXPIRED (409). No cancel after acceptance.", "tags": [ "lead-data-reset" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetPreview" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyInput" } } } } } }, "/api/v1/lead-data-reset/{id}/resume": { "post": { "operationId": "post_lead_data_reset__id_resume", "summary": "POST /lead-data-reset/:id/resume", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Google/App Check Admin-only; PAT denied. Clear all active/archived leads and related data, retain users/configuration and standalone reminders. Preview expires after ten minutes; confirmation includes concurrent additions. Cleanup waits five minutes then runs in bounded resumable batches; lead mutations return LEAD_DATA_RESET (503) while active/blocked. Old idempotency receipts are redacted and return RESET_REQUEST_EXPIRED (409). No cancel after acceptance.", "tags": [ "lead-data-reset" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetResume" } } } } } }, "/api/v1/archived-leads": { "get": { "operationId": "get_archived_leads", "summary": "GET /archived-leads", "description": "Requires: leads:read. Personal access token scope: leads:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "archived-leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:read", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Lead" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads": { "get": { "operationId": "get_leads", "summary": "GET /leads", "description": "Requires: leads:read. Personal access token scope: leads:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:read", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." }, { "in": "query", "name": "stage", "schema": { "type": "string" } }, { "in": "query", "name": "source", "schema": { "type": "string" } }, { "in": "query", "name": "assignedToUid", "schema": { "type": "string" } }, { "in": "query", "name": "search", "schema": { "type": "string" }, "description": "With column filters, case-insensitive contains search; city/sector use the same scanning path. Legacy queries without filters retain name/company prefix and normalized exact contact matching." }, { "in": "query", "name": "field", "schema": { "type": "string", "enum": [ "name", "company", "phone", "email", "location", "zone" ] } }, { "in": "query", "name": "filters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadFilters" }, "example": [] } }, "description": "AND-combined column filters. Use JSON in the filters query parameter. Case-insensitive contains/equals/startsWith, empty/notEmpty and before/after for dates. The additive exact operator supports source, stage and configured custom dropdowns only: raw case, spaces and Unicode must match saved values. Every exact predicate uses indexed equality with document-ID ordering; other conditions retain bounded residual scanning. Existing equals behavior is unchanged. Signed continuation cursors bind all filters and identity. Empty pages may still have nextCursor; continue until null. Does not search all historical comment text: use the source discussion fields or latestComment." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Lead" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_leads", "summary": "POST /leads", "description": "Requires: leads:create. Personal access token scope: leads:create. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:create", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lead" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadInput" } } } } } }, "/api/v1/leads/{id}/attachments": { "post": { "operationId": "post_leads__id_attachments", "summary": "POST /leads/:id/attachments", "description": "Requires: leads:edit. Personal access token scope: attachments:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Private lead files in Firebase Storage. 8 MiB per file, 50 active/pending per lead. Metadata reservation requires UUID Idempotency-Key; PUT uploads application/octet-stream after type/size checks. Same bytes can be retried for one hour. Only the reserver can complete an upload. No public download URL is issued; current membership, token and lead scope are rechecked for downloads. Removal hides access immediately and schedules physical cleanup; abandoned pending uploads expire.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "attachments:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Attachment" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "File exceeds 8 MiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "415": { "description": "Binary upload requires application/octet-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentInput" } } } } }, "get": { "operationId": "get_leads__id_attachments", "summary": "GET /leads/:id/attachments", "description": "Requires: leads:read. Personal access token scope: attachments:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Private lead files in Firebase Storage. 8 MiB per file, 50 active/pending per lead. Metadata reservation requires UUID Idempotency-Key; PUT uploads application/octet-stream after type/size checks. Same bytes can be retried for one hour. Only the reserver can complete an upload. No public download URL is issued; current membership, token and lead scope are rechecked for downloads. Removal hides access immediately and schedules physical cleanup; abandoned pending uploads expire.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "attachments:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Attachment" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "File exceeds 8 MiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "415": { "description": "Binary upload requires application/octet-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/attachments/{attachmentId}/content": { "put": { "operationId": "put_leads__id_attachments__attachmentId_content", "summary": "PUT /leads/:id/attachments/:attachmentId/content", "description": "Requires: leads:edit. Personal access token scope: attachments:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Private lead files in Firebase Storage. 8 MiB per file, 50 active/pending per lead. Metadata reservation requires UUID Idempotency-Key; PUT uploads application/octet-stream after type/size checks. Same bytes can be retried for one hour. Only the reserver can complete an upload. No public download URL is issued; current membership, token and lead scope are rechecked for downloads. Removal hides access immediately and schedules physical cleanup; abandoned pending uploads expire.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "attachments:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "attachmentId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Attachment" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "File exceeds 8 MiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "415": { "description": "Binary upload requires application/octet-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary", "maxLength": 8388608 } } } } }, "get": { "operationId": "get_leads__id_attachments__attachmentId_content", "summary": "GET /leads/:id/attachments/:attachmentId/content", "description": "Requires: leads:read. Personal access token scope: attachments:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Private lead files in Firebase Storage. 8 MiB per file, 50 active/pending per lead. Metadata reservation requires UUID Idempotency-Key; PUT uploads application/octet-stream after type/size checks. Same bytes can be retried for one hour. Only the reserver can complete an upload. No public download URL is issued; current membership, token and lead scope are rechecked for downloads. Removal hides access immediately and schedules physical cleanup; abandoned pending uploads expire.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "attachments:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "attachmentId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Authenticated forced file download; Cache-Control no-store and nosniff. No redirect or permanent URL.", "headers": { "Content-Disposition": { "schema": { "type": "string" } } }, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "File exceeds 8 MiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "415": { "description": "Binary upload requires application/octet-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/attachments/{attachmentId}": { "delete": { "operationId": "delete_leads__id_attachments__attachmentId", "summary": "DELETE /leads/:id/attachments/:attachmentId", "description": "Requires: leads:edit. Personal access token scope: attachments:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Private lead files in Firebase Storage. 8 MiB per file, 50 active/pending per lead. Metadata reservation requires UUID Idempotency-Key; PUT uploads application/octet-stream after type/size checks. Same bytes can be retried for one hour. Only the reserver can complete an upload. No public download URL is issued; current membership, token and lead scope are rechecked for downloads. Removal hides access immediately and schedules physical cleanup; abandoned pending uploads expire.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "attachments:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "attachmentId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "File exceeds 8 MiB", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "415": { "description": "Binary upload requires application/octet-stream", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentDelete" } } } } } }, "/api/v1/leads/batch/preview": { "post": { "operationId": "post_leads_batch_preview", "summary": "POST /leads/batch/preview", "description": "Requires: leads:edit. Personal access token scope: leads:bulk-edit. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Explicit selection of 1–25 unique lead IDs and expected versions. Preview writes nothing; apply is atomic and requires a UUID Idempotency-Key. Current access, all versions, field definitions and assignee are rechecked at commit. Identity/contact/discussion/suppression fields are excluded. Assignment changes cancel pending tasks and notify new owners; PAT reassignment also requires assignments:write. Batch task cancellation is bounded to 200 pending tasks and serialized old/new/task data to 2 MiB; reduce selection if rejected.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:bulk-edit", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkLeadResult" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "Batch stored-data budget exceeded; select fewer leads", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkLeadInput" } } } } } }, "/api/v1/leads/batch": { "post": { "operationId": "post_leads_batch", "summary": "POST /leads/batch", "description": "Requires: leads:edit. Personal access token scope: leads:bulk-edit. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Explicit selection of 1–25 unique lead IDs and expected versions. Preview writes nothing; apply is atomic and requires a UUID Idempotency-Key. Current access, all versions, field definitions and assignee are rechecked at commit. Identity/contact/discussion/suppression fields are excluded. Assignment changes cancel pending tasks and notify new owners; PAT reassignment also requires assignments:write. Batch task cancellation is bounded to 200 pending tasks and serialized old/new/task data to 2 MiB; reduce selection if rejected.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:bulk-edit", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkLeadResult" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "Batch stored-data budget exceeded; select fewer leads", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkLeadInput" } } } } } }, "/api/v1/leads/{id}": { "get": { "operationId": "get_leads__id", "summary": "GET /leads/:id", "description": "Requires: leads:read. Personal access token scope: leads:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lead" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_leads__id", "summary": "PATCH /leads/:id", "description": "Requires: leads:edit. Personal access token scope: leads:edit. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:edit", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lead" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadPatch" } } } } } }, "/api/v1/leads/{id}/archive": { "post": { "operationId": "post_leads__id_archive", "summary": "POST /leads/:id/archive", "description": "Requires: leads:edit. Personal access token scope: leads:archive. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. The first archive transition atomically records an actor-attributed Lead archived activity. Repeating with the current archived version returns OK without another activity. Only Pending outreach tasks are cancelled; administrative tasks retain their state.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:archive", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveInput" } } } } } }, "/api/v1/leads/{id}/restore": { "post": { "operationId": "post_leads__id_restore", "summary": "POST /leads/:id/restore", "description": "Requires: leads:edit. Personal access token scope: leads:archive. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Restore an accessible archived lead using expectedVersion. Retains suppression, assignment and shared contact ownership. Conflicting newly acquired contacts return DUPLICATE. Atomically records an actor-attributed restore activity and lifecycle event. Cancelled outreach is never rescheduled.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:archive", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lead" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ArchiveInput" } } } } } }, "/api/v1/leads/{id}/assignment": { "patch": { "operationId": "patch_leads__id_assignment", "summary": "PATCH /leads/:id/assignment", "description": "Requires: assignments:write. Personal access token scope: assignments:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "assignments:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lead" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignmentPatch" } } } } } }, "/api/v1/leads/{id}/journey": { "get": { "operationId": "get_leads__id_journey", "summary": "GET /leads/:id/journey", "description": "Requires: leads:read. Personal access token scope: leads:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "leads:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "required": [ "items", "nextCursor", "currentStage", "historyComplete" ], "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "leadId": { "type": "string" }, "from": { "type": [ "string", "null" ] }, "to": { "type": "string" }, "leadVersion": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string" } } } }, "nextCursor": { "type": [ "string", "null" ] }, "currentStage": { "type": "string" }, "historyComplete": { "type": "boolean", "description": "Whether an app-creation transition is recorded; never fabricated for legacy leads." } } } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/activities": { "get": { "operationId": "get_leads__id_activities", "summary": "GET /leads/:id/activities", "description": "Requires: leads:read. Personal access token scope: activities:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "activities:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_leads__id_activities", "summary": "POST /leads/:id/activities", "description": "Requires: activities:write. Personal access token scope: activities:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Including stage requires leads:edit; including a manual followUp requires tasks:write. Notes may trigger automatic reminder analysis according to owner preferences.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "activities:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CallSaved" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ActivityInput" } } } } } }, "/api/v1/activities/{id}/corrections": { "post": { "operationId": "post_activities__id_corrections", "summary": "POST /activities/:id/corrections", "description": "Requires: activities:write. Personal access token scope: activities:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "activities" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "activities:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Activity" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "type": { "type": "string", "enum": [ "call", "note" ] }, "outcome": { "type": "string", "minLength": 1, "maxLength": 100 }, "disposition": { "default": "None", "type": "string", "minLength": 1, "maxLength": 100 }, "notes": { "default": "", "type": "string", "maxLength": 4000 }, "durationSeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "expectedRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "disposition", "notes", "expectedRevision" ], "additionalProperties": false } } } } } }, "/api/v1/activities/{id}/automatic-reminder": { "patch": { "operationId": "patch_activities__id_automatic_reminder", "summary": "PATCH /activities/:id/automatic-reminder", "description": "Requires: tasks:write. Personal access token scope: tasks:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "activities" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Activity" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutomaticReminderAction" } } } } } }, "/api/v1/tasks": { "get": { "operationId": "get_tasks", "summary": "GET /tasks", "description": "Requires: leads:read. Personal access token scope: tasks:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "tasks" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:read", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." }, { "in": "query", "name": "view", "schema": { "type": "string", "enum": [ "accessible" ] }, "description": "Optional Google/App Check member-only accessible lead work plus own personal reminders. Omit for legacy recipient-only tasks; PAT cannot opt in. Sparse pages may continue through nextCursor. Current lead scope and mutation capabilities are rechecked." }, { "in": "query", "name": "state", "schema": { "type": "string" } }, { "in": "query", "name": "leadId", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Task" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_tasks", "summary": "POST /tasks", "description": "Requires: tasks:write. Personal access token scope: tasks:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "tasks" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:write", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskInput" } } } } } }, "/api/v1/tasks/{id}": { "get": { "operationId": "get_tasks__id", "summary": "GET /tasks/:id", "description": "Requires: leads:read. Personal access token scope: tasks:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "tasks" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_tasks__id", "summary": "PATCH /tasks/:id", "description": "Requires: tasks:write. Personal access token scope: tasks:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "tasks" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskPatch" } } } } }, "delete": { "operationId": "delete_tasks__id", "summary": "DELETE /tasks/:id", "description": "Requires: tasks:write. Personal access token scope: tasks:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "tasks" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskDelete" } } } } } }, "/api/v1/leads/{id}/tasks": { "get": { "operationId": "get_leads__id_tasks", "summary": "GET /leads/:id/tasks", "description": "Requires: leads:read. Personal access token scope: tasks:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "tasks:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed continuation bound to lead, state filter and current membership." }, { "in": "query", "name": "state", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Task" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/tasks/{taskId}": { "patch": { "operationId": "patch_leads__id_tasks__taskId", "summary": "PATCH /leads/:id/tasks/:taskId", "description": "Requires: leads:edit. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "taskId", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same UUID and body after an uncertain response. Current lead edit access is rechecked on replay." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Task" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SharedTaskPatch" } } } } } }, "/api/v1/lead-assignees": { "get": { "operationId": "get_lead_assignees", "summary": "GET /lead-assignees", "description": "Requires: leads:read. Personal access token scope: people:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Admin-only minimal assignee directory, including inactive members. Google sessions require members:write; PATs require explicit people:read scope. No account email or capabilities are returned.", "tags": [ "lead-assignees" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "people:read", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/team": { "get": { "operationId": "get_team", "summary": "GET /team", "description": "Requires: leads:read. Personal access token scope: team:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Admin role is always required; Google sessions also require members:write. PATs require explicit team:read scope. Recorded activity uses UTC calendar days (7/30/90; default 30), bounded scans and current lead scope. Imported text, deleted-source activities and personal reminders are excluded. No employee rating or online status. Counts are current reads, not a transactional snapshot. Access is rechecked before publication. 413 TEAM_LIMIT rejects oversized reports rather than partial totals; 409 TEAM_STALE requires refresh.", "tags": [ "team" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "team:read", "parameters": [ { "in": "query", "name": "days", "schema": { "type": "integer", "enum": [ 7, 30, 90 ], "default": 30 } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/team/members/{uid}/activities": { "get": { "operationId": "get_team_members__uid_activities", "summary": "GET /team/members/:uid/activities", "description": "Requires: leads:read. Personal access token scope: team:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Admin role is always required; Google sessions also require members:write. PATs require explicit team:read scope. Recorded activity uses UTC calendar days (7/30/90; default 30), bounded scans and current lead scope. Imported text, deleted-source activities and personal reminders are excluded. No employee rating or online status. Counts are current reads, not a transactional snapshot. Access is rechecked before publication. 413 TEAM_LIMIT rejects oversized reports rather than partial totals; 409 TEAM_STALE requires refresh.", "tags": [ "team" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "team:read", "parameters": [ { "in": "path", "name": "uid", "required": true, "schema": { "type": "string" } }, { "in": "query", "name": "days", "schema": { "type": "integer", "enum": [ 7, 30, 90 ], "default": 30 } }, { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Encrypted continuation bound to member, period, requester and current access. Sparse pages can continue." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Activity" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/members": { "get": { "operationId": "get_members", "summary": "GET /members", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "members" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Member" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/invitations": { "get": { "operationId": "get_invitations", "summary": "GET /invitations", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "invitations" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Invitation" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_invitations", "summary": "POST /invitations", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "invitations" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Invitation" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GrantInput" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/invitations/{id}": { "delete": { "operationId": "delete_invitations__id", "summary": "DELETE /invitations/:id", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "invitations" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/members/{uid}": { "patch": { "operationId": "patch_members__uid", "summary": "PATCH /members/:uid", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "members" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "uid", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Member" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemberPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/imports": { "get": { "operationId": "get_imports", "summary": "GET /imports", "description": "Requires: imports:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "status", "required": false, "schema": { "type": "string" }, "description": "Import lifecycle status" }, { "in": "query", "name": "uploader", "required": false, "schema": { "type": "string" }, "description": "Creator UID; shared access is required to select another member" }, { "in": "query", "name": "from", "required": false, "schema": { "type": "string" }, "description": "ISO date-time, inclusive" }, { "in": "query", "name": "to", "required": false, "schema": { "type": "string" }, "description": "ISO date-time, inclusive" }, { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ImportJob" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/imports/{id}/rows": { "get": { "operationId": "get_imports__id_rows", "summary": "GET /imports/:id/rows", "description": "Requires: imports:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ImportRow" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/imports/{id}/report": { "get": { "operationId": "get_imports__id_report", "summary": "GET /imports/:id/report", "description": "Requires: imports:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ImportRow" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/imports/{id}/plan": { "post": { "operationId": "post_imports__id_plan", "summary": "POST /imports/:id/plan", "description": "Requires: imports:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportVersion" } } } } } }, "/api/v1/imports/{id}/review": { "post": { "operationId": "post_imports__id_review", "summary": "POST /imports/:id/review", "description": "Requires: imports:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportVersion" } } } } } }, "/api/v1/imports/{id}/rows/{index}": { "patch": { "operationId": "patch_imports__id_rows__index", "summary": "PATCH /imports/:id/rows/:index", "description": "Requires: imports:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "path", "name": "index", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportDecision" } } } } } }, "/api/v1/imports/{id}/refresh": { "post": { "operationId": "post_imports__id_refresh", "summary": "POST /imports/:id/refresh", "description": "Requires: imports:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportVersion" } } } } } }, "/api/v1/imports/{id}": { "delete": { "operationId": "delete_imports__id", "summary": "DELETE /imports/:id", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportDelete" } } } } }, "get": { "operationId": "get_imports__id", "summary": "GET /imports/:id", "description": "Requires: imports:read. Personal access token scope: imports:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "imports:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/imports/preview": { "post": { "operationId": "post_imports_preview", "summary": "POST /imports/preview", "description": "Requires: imports:write. Personal access token scope: imports:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "imports:write", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportInput" } } } } } }, "/api/v1/imports/{id}/errors": { "get": { "operationId": "get_imports__id_errors", "summary": "GET /imports/:id/errors", "description": "Requires: imports:read. Personal access token scope: imports:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "imports:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ImportError" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/imports/{id}/commit": { "post": { "operationId": "post_imports__id_commit", "summary": "POST /imports/:id/commit", "description": "Requires: imports:write. Personal access token scope: imports:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "imports" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "imports:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportJob" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ImportCommit" } } } } } }, "/api/v1/notifications": { "get": { "operationId": "get_notifications", "summary": "GET /notifications", "description": "Requires: leads:read. Personal access token scope: notifications:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "notifications" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "notifications:read", "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Notification" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/notifications/{id}": { "patch": { "operationId": "patch_notifications__id", "summary": "PATCH /notifications/:id", "description": "Requires: leads:read. Personal access token scope: notifications:write. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "notifications" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "notifications:write", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationPatch" } } } } } }, "/api/v1/devices": { "get": { "operationId": "get_devices", "summary": "GET /devices", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "devices" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 30 } }, { "in": "query", "name": "cursor", "schema": { "type": "string" }, "description": "Opaque signed cursor bound to filters, identity and membership version." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/Device" } }, "nextCursor": { "type": [ "string", "null" ] } }, "required": [ "items", "nextCursor" ] } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "post": { "operationId": "post_devices", "summary": "POST /devices", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "devices" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "type": "string", "format": "uuid" }, "description": "Reuse the same key and body after an uncertain response." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Device" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeviceInput" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/devices/{id}": { "delete": { "operationId": "delete_devices__id", "summary": "DELETE /devices/:id", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "devices" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/devices/{id}/test": { "post": { "operationId": "post_devices__id_test", "summary": "POST /devices/:id/test", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "devices" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/scoring-settings": { "get": { "operationId": "get_scoring_settings", "summary": "GET /scoring-settings", "description": "Requires: leads:read. Personal access token scope: configuration:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "scoring-settings" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "configuration:read", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScoringConfig" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } }, "patch": { "operationId": "patch_scoring_settings", "summary": "PATCH /scoring-settings", "description": "Requires: members:write. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "scoring-settings" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScoringConfig" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScoringPatch" } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } }, "/api/v1/lead-scores": { "get": { "operationId": "get_lead_scores", "summary": "GET /lead-scores", "description": "Requires: leads:read. Personal access token scope: scores:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "lead-scores" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "scores:read", "parameters": [ { "in": "query", "name": "ids", "required": true, "schema": { "type": "string" }, "description": "Comma-separated lead IDs, at most 100. Every ID must be within the caller scope." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/LeadScore" } } } } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/score": { "get": { "operationId": "get_leads__id_score", "summary": "GET /leads/:id/score", "description": "Requires: leads:read. Personal access token scope: scores:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "scores:read", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadScore" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/leads/{id}/score/refresh": { "post": { "operationId": "post_leads__id_score_refresh", "summary": "POST /leads/:id/score/refresh", "description": "Requires: leads:edit. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "leads" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeadScore" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyInput" } } } } } }, "/api/v1/dashboard": { "get": { "operationId": "get_dashboard", "summary": "GET /dashboard", "description": "Requires: leads:read. Personal access token scope: dashboard:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "dashboard" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "dashboard:read", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Dashboard" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/dashboard/insights": { "post": { "operationId": "post_dashboard_insights", "summary": "POST /dashboard/insights", "description": "Requires: leads:read. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "dashboard" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DashboardBrief" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EmptyInput" } } } } } }, "/api/v1/summary": { "get": { "operationId": "get_summary", "summary": "GET /summary", "description": "Requires: leads:read. Personal access token scope: dashboard:read. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store.", "tags": [ "summary" ], "security": [ { "personalAccessToken": [] }, { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": "dashboard:read", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Summary" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } } } }, "/api/v1/invitations/{id}/accept": { "post": { "operationId": "post_invitations__id_accept", "summary": "POST /invitations/:id/accept", "description": "Requires: Matching verified Google identity. Google sign-in and App Check required; personal access tokens are not accepted. Server verifies current membership and assigned/all lead scope. Private responses use Cache-Control: no-store. Saved net configuration changes create an atomic server-side audit and privacy-safe Dynatrace outbox event. No values are exported; unchanged/failed/denied/replayed saves do not create duplicate success changes. No audit-read endpoint or token scope is granted.", "tags": [ "invitations" ], "security": [ { "firebaseIdToken": [], "appCheck": [] } ], "x-personal-access-token-scope": null, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Ok" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "400": { "description": "Validation failure or BAD_JSON for malformed JSON; parser errors never echo request content", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "401": { "description": "Missing, invalid, expired or revoked credential", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "WWW-Authenticate": { "schema": { "type": "string" }, "description": "Bearer authentication challenge" } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "404": { "description": "Resource unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "409": { "description": "Duplicate, stale version or conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE: request exceeds the endpoint body limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string", "const": "60" }, "description": "Wait at least 60 seconds before retrying" } } }, "500": { "description": "Internal failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "502": { "description": "AI response could not be grounded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } }, "503": { "description": "Dependency or account verification temporarily unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } }, "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } }, "X-Request-Id": { "schema": { "type": "string", "format": "uuid" } }, "X-App-Version": { "schema": { "type": "string" } } } } }, "x-settings-audit": { "eventType": "com.avinyatech.salesdrone.settings.audit.committed", "atomic": true, "valuesExported": false, "auditReadScopeAdded": false } } } }, "components": { "securitySchemes": { "personalAccessToken": { "type": "http", "scheme": "bearer", "bearerFormat": "sd_pat__", "description": "Generate in Settings → Developer settings → Personal Access Tokens. Enter the raw token, without Bearer. Stored only in memory by this portal. Scope and active owner permissions are rechecked server-side; not accepted for Google-only operations." }, "firebaseIdToken": { "type": "http", "scheme": "bearer", "bearerFormat": "Firebase ID token" }, "appCheck": { "type": "apiKey", "in": "header", "name": "X-Firebase-AppCheck" } }, "schemas": { "LeadInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "default": "", "type": "string", "maxLength": 200 }, "phone": { "default": "", "type": "string", "maxLength": 40 }, "email": { "default": "", "anyOf": [ { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "string", "const": "" } ] }, "company": { "default": "", "type": "string", "maxLength": 200 }, "jobTitle": { "default": "", "type": "string", "maxLength": 200 }, "source": { "default": "Direct enquiry", "type": "string", "maxLength": 200 }, "location": { "default": "", "type": "string", "maxLength": 200 }, "zone": { "default": "", "type": "string", "maxLength": 200 }, "enquiryDate": { "default": "", "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "const": "" } ] }, "stage": { "default": "New", "type": "string", "minLength": 1, "maxLength": 100 }, "comments": { "default": "", "type": "string", "maxLength": 4000 }, "initialDiscussion": { "default": "", "type": "string", "maxLength": 4000 }, "followUp1": { "default": "", "type": "string", "maxLength": 4000 }, "followUp2": { "default": "", "type": "string", "maxLength": 4000 }, "followUp3": { "default": "", "type": "string", "maxLength": 4000 }, "followUp4": { "default": "", "type": "string", "maxLength": 4000 }, "originalPhone": { "default": "", "type": "string", "maxLength": 200 }, "originalEnquiryDate": { "default": "", "type": "string", "maxLength": 100 }, "legacyStatus": { "default": "", "type": "string", "maxLength": 200 }, "serial": { "default": "", "type": "string", "maxLength": 80 }, "customFields": { "default": {}, "type": "object", "propertyNames": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "tags": { "default": [], "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 40 } }, "website": { "default": "", "type": "string", "maxLength": 300 }, "countryCode": { "default": "+91", "type": "string", "pattern": "^\\+\\d{1,3}$" }, "allowDuplicate": { "default": false, "type": "boolean" }, "needsReview": { "default": false, "type": "boolean" } }, "additionalProperties": false }, "LeadPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "phone": { "type": "string", "maxLength": 40 }, "email": { "anyOf": [ { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "string", "const": "" } ] }, "company": { "type": "string", "maxLength": 200 }, "jobTitle": { "type": "string", "maxLength": 200 }, "source": { "type": "string", "maxLength": 200 }, "location": { "type": "string", "maxLength": 200 }, "zone": { "type": "string", "maxLength": 200 }, "enquiryDate": { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "const": "" } ] }, "stage": { "type": "string", "minLength": 1, "maxLength": 100 }, "comments": { "type": "string", "maxLength": 4000 }, "initialDiscussion": { "type": "string", "maxLength": 4000 }, "followUp1": { "type": "string", "maxLength": 4000 }, "followUp2": { "type": "string", "maxLength": 4000 }, "followUp3": { "type": "string", "maxLength": 4000 }, "followUp4": { "type": "string", "maxLength": 4000 }, "originalPhone": { "type": "string", "maxLength": 200 }, "originalEnquiryDate": { "type": "string", "maxLength": 100 }, "legacyStatus": { "type": "string", "maxLength": 200 }, "serial": { "type": "string", "maxLength": 80 }, "customFields": { "type": "object", "propertyNames": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "tags": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 40 } }, "website": { "type": "string", "maxLength": 300 }, "countryCode": { "type": "string", "pattern": "^\\+\\d{1,3}$" }, "needsReview": { "type": "boolean" }, "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "doNotContact": { "type": "boolean" }, "suppressionReason": { "type": "string", "maxLength": 500 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "ArchiveInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "AssignmentPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "assignedToUid": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "expectedVersion", "assignedToUid" ], "additionalProperties": false }, "NotificationPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "read": { "default": true, "type": "boolean" } }, "additionalProperties": false }, "TaskInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 250 }, "leadId": { "type": "string", "maxLength": 100 }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "default": "Asia/Kolkata", "type": "string", "maxLength": 100 }, "kind": { "default": "outreach", "type": "string", "enum": [ "outreach", "administrative" ] } }, "required": [ "title", "dueAt" ], "additionalProperties": false }, "TaskPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "title": { "type": "string", "minLength": 1, "maxLength": 250 }, "kind": { "type": "string", "enum": [ "outreach", "administrative" ] }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "type": "string", "maxLength": 100 }, "state": { "type": "string", "enum": [ "Pending", "Completed", "Cancelled" ] } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "SharedTaskPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "anyOf": [ { "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "state": { "type": "string", "const": "Completed" } }, "required": [ "expectedVersion", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "type": "string", "maxLength": 100 } }, "required": [ "expectedVersion", "dueAt" ], "additionalProperties": false } ] }, "TaskDelete": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "ActivityInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "type": { "type": "string", "enum": [ "call", "note" ] }, "outcome": { "type": "string", "minLength": 1, "maxLength": 100 }, "disposition": { "default": "None", "type": "string", "minLength": 1, "maxLength": 100 }, "notes": { "default": "", "type": "string", "maxLength": 4000 }, "durationSeconds": { "type": "integer", "minimum": 0, "maximum": 86400 }, "stage": { "type": "string", "minLength": 1, "maxLength": 100 }, "followUp": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 250 }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "default": "Asia/Kolkata", "type": "string", "maxLength": 100 }, "kind": { "default": "outreach", "type": "string", "enum": [ "outreach", "administrative" ] } }, "required": [ "title", "dueAt" ], "additionalProperties": false }, "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "type", "expectedVersion" ], "additionalProperties": false }, "AutomaticReminderAction": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "action": { "type": "string", "const": "retry" }, "expectedRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "action", "expectedRevision" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "dismiss" }, "expectedRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "action", "expectedRevision" ], "additionalProperties": false }, { "type": "object", "properties": { "action": { "type": "string", "const": "schedule" }, "expectedRevision": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "task": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 250 }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "default": "Asia/Kolkata", "type": "string", "maxLength": 100 }, "kind": { "default": "outreach", "type": "string", "enum": [ "outreach", "administrative" ] } }, "required": [ "title", "dueAt" ], "additionalProperties": false } }, "required": [ "action", "expectedRevision", "task" ], "additionalProperties": false } ] }, "GrantInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "email": { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "role": { "type": "string", "enum": [ "Viewer", "SDR" ] }, "scope": { "default": "assigned", "type": "string", "enum": [ "assigned", "all" ] }, "capabilities": { "maxItems": 14, "type": "array", "items": { "type": "string", "enum": [ "leads:read", "leads:create", "leads:edit", "activities:write", "tasks:write", "imports:read", "imports:write", "imports:share", "members:write", "assignments:write", "hygiene:read", "hygiene:run", "hygiene:ai", "assistant:query" ] } } }, "required": [ "email", "role" ], "additionalProperties": false }, "MemberPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "active": { "type": "boolean" }, "role": { "type": "string", "enum": [ "Viewer", "SDR" ] }, "scope": { "type": "string", "enum": [ "assigned", "all" ] }, "capabilities": { "maxItems": 14, "type": "array", "items": { "type": "string", "enum": [ "leads:read", "leads:create", "leads:edit", "activities:write", "tasks:write", "imports:read", "imports:write", "imports:share", "members:write", "assignments:write", "hygiene:read", "hygiene:run", "hygiene:ai", "assistant:query" ] } }, "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "active", "role", "scope", "expectedVersion" ], "additionalProperties": false }, "Preferences": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "timezone": { "type": "string", "maxLength": 100 }, "appearance": { "type": "string", "enum": [ "system", "light", "dark" ] }, "dashboardField": { "anyOf": [ { "type": "string", "enum": [ "auto", "stage", "legacyStatus", "source", "zone", "location" ] }, { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" } ], "description": "Personal pipeline visualization category. Default auto chooses the first available field: stage, enquiry status, source, sector, location, then custom text/dropdown fields. Active members edit only their own preference; hidden/retired fields are rejected on save and existing unavailable choices fall back without rewriting the preference. PATCH supports partial preferences; omitted keys are preserved. PAT writes are denied." }, "bookMode": { "type": "boolean", "description": "Personal reading style, default false. Omission preserves the stored value; does not alter theme, timezone or permissions." }, "fontStyle": { "type": "string", "enum": [ "standard", "inter", "source-sans", "lora" ], "description": "Personal interface font: standard (default), inter, source-sans or lora. Omission preserves the saved value. Book mode keeps its own serif family; no authorization change. Google sign-in/App Check only; PAT writes denied." }, "displayScale": { "anyOf": [ { "type": "number", "const": 85 }, { "type": "number", "const": 90 }, { "type": "number", "const": 100 }, { "type": "number", "const": 110 }, { "type": "number", "const": 125 } ], "description": "Personal display zoom percentage: 85, 90, 100 (default), 110 or 125. Omission preserves the saved value. The current UI applies it on phones, tablets and desktops after saving, retaining usable touch targets. Browser zoom is unrestricted. Self-service Google/App Check only; PAT writes denied." }, "automaticReminders": { "type": "boolean" }, "reminderTime": { "type": "string", "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$" }, "nextWeekRule": { "type": "string", "enum": [ "seven_days", "next_monday" ] }, "moveWeekends": { "type": "boolean" } }, "additionalProperties": false }, "DeviceInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "token": { "type": "string", "minLength": 20, "maxLength": 4096 }, "label": { "type": "string", "maxLength": 100 } }, "required": [ "id", "token", "label" ], "additionalProperties": false }, "ImportInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "filename": { "type": "string", "maxLength": 250 }, "sheet": { "type": "string", "maxLength": 100 }, "rows": { "maxItems": 5000, "type": "array", "items": { "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {}, "properties": { "importComments": { "type": "array", "maxItems": 40, "items": { "$ref": "#/components/schemas/ImportComment" }, "description": "Each nonempty selected spreadsheet cell becomes a separate historical note. Other keys are standard lead fields." } } } }, "statusMap": { "default": {}, "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 100 } }, "statusField": { "anyOf": [ { "type": "string", "enum": [ "none", "legacyStatus", "stage", "source", "zone", "location" ] }, { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" } ], "description": "Reviewed imports only. New browser uploads default to legacyStatus (Enquiry status): retain workbook text unless explicitly remapped. Choose none, an available built-in category or custom text/select field. Hidden/retired targets and targets already supplied by another mapped column are rejected. Non-text categories require configured values. Omission preserves legacy stage mapping for old API clients. Original sourceStatus remains in permission-filtered import row details." }, "dateOrder": { "default": "DMY", "type": "string", "enum": [ "DMY", "MDY" ] }, "blankRows": { "default": 0, "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "duplicateMode": { "default": "skip", "type": "string", "enum": [ "skip", "keep", "update" ] }, "reviewed": { "type": "boolean" }, "sourceImportId": { "type": "string", "minLength": 1, "maxLength": 150 } }, "required": [ "filename", "sheet", "rows" ], "additionalProperties": false }, "ImportComment": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "sourceColumn": { "type": "string", "minLength": 1, "maxLength": 100 }, "sourceIndex": { "type": "integer", "minimum": 0, "maximum": 39 }, "notes": { "type": "string", "maxLength": 4000 } }, "required": [ "sourceColumn", "sourceIndex", "notes" ], "additionalProperties": false }, "ImportVersion": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "ImportDecision": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "action": { "type": "string", "enum": [ "accept", "skip", "create", "match" ] }, "leadId": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,150}$" }, "incomingFields": { "default": [], "maxItems": 70, "type": "array", "items": { "type": "string", "maxLength": 100 } }, "clearFields": { "default": [], "maxItems": 30, "type": "array", "items": { "type": "string", "maxLength": 100 } } }, "required": [ "expectedVersion", "action" ], "additionalProperties": false }, "ImportDelete": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "confirmation": { "type": "string", "const": "DELETE IMPORT DETAILS" } }, "required": [ "expectedVersion", "confirmation" ], "additionalProperties": false }, "ImportCommit": { "anyOf": [ { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, { "type": "object", "additionalProperties": false } ], "description": "Reviewed jobs require expectedVersion. Legacy jobs accept an empty body." }, "ResetConfirmation": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "previewId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "confirmation": { "type": "string", "const": "DELETE ALL LEADS" } }, "required": [ "previewId", "confirmation" ], "additionalProperties": false }, "ResetResume": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "ResetJob": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "Waiting", "Running", "Blocked", "Completed" ] }, "phase": { "type": "string" }, "version": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time" }, "readyAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": [ "string", "null" ] }, "deletedRecords": { "type": "integer" }, "deletedFiles": { "type": "integer" }, "redactedRequests": { "type": "integer" }, "lastError": { "type": [ "string", "null" ] } }, "required": [ "id", "status", "phase", "version", "deletedRecords", "deletedFiles", "redactedRequests" ] }, "ResetStatus": { "type": "object", "properties": { "active": { "type": "boolean" }, "job": { "anyOf": [ { "type": "null" }, { "$ref": "#/components/schemas/ResetJob" } ] } }, "required": [ "active", "job" ] }, "ResetPreview": { "type": "object", "properties": { "previewId": { "type": "string", "format": "uuid" }, "expiresAt": { "type": "string", "format": "date-time" }, "counts": { "type": "object", "properties": { "leads": { "type": "integer" }, "archived": { "type": "integer" } }, "required": [ "leads", "archived" ] } }, "required": [ "previewId", "expiresAt", "counts" ] }, "BulkLeadInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "minItems": 1, "maxItems": 25, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_.:-]{1,150}$" }, "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "id", "expectedVersion" ], "additionalProperties": false } }, "changes": { "type": "object", "properties": { "company": { "type": "string", "maxLength": 200 }, "jobTitle": { "type": "string", "maxLength": 200 }, "source": { "type": "string", "maxLength": 200 }, "location": { "type": "string", "maxLength": 200 }, "zone": { "type": "string", "maxLength": 200 }, "legacyStatus": { "type": "string", "maxLength": 200 }, "stage": { "type": "string", "minLength": 1, "maxLength": 100 }, "tags": { "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 40 } }, "customFields": { "type": "object", "propertyNames": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "additionalProperties": false }, "assignedToUid": { "anyOf": [ { "type": "string", "minLength": 1, "maxLength": 100 }, { "type": "null" } ] } }, "required": [ "items", "changes" ], "additionalProperties": false }, "AttachmentInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 180 }, "size": { "type": "integer", "minimum": 1, "maximum": 8388608 }, "contentType": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/gif", "image/webp", "application/pdf", "text/plain", "text/csv", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "application/vnd.ms-powerpoint", "application/vnd.openxmlformats-officedocument.presentationml.presentation" ] } }, "required": [ "name", "size", "contentType" ], "additionalProperties": false }, "AttachmentDelete": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "Attachment": { "type": "object", "required": [ "id", "leadId", "name", "size", "contentType", "state", "version" ], "properties": { "id": { "type": "string" }, "leadId": { "type": "string" }, "name": { "type": "string" }, "size": { "type": "integer", "maximum": 8388608 }, "contentType": { "type": "string" }, "state": { "type": "string", "enum": [ "Pending", "Ready" ] }, "version": { "type": "integer" }, "createdAt": { "type": "string", "format": "date-time" }, "createdByUid": { "type": "string" } } }, "BulkLeadResult": { "type": "object", "required": [ "count", "changedCount", "items" ], "properties": { "count": { "type": "integer", "maximum": 25 }, "changedCount": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "version": { "type": "integer" }, "changed": { "type": "boolean" }, "before": { "type": "object" }, "after": { "type": "object" } } } } } }, "ScoringPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "enabled": { "type": "boolean" }, "factors": { "maxItems": 30, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,59}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "group": { "type": "string", "enum": [ "fit", "intent", "risk" ] }, "weight": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": { "type": "string", "minLength": 10, "maxLength": 600 }, "enabled": { "type": "boolean" } }, "required": [ "id", "label", "group", "weight", "description", "enabled" ], "additionalProperties": false } } }, "required": [ "expectedVersion", "enabled", "factors" ], "additionalProperties": false }, "TokenInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "scopes": { "minItems": 1, "maxItems": 22, "type": "array", "items": { "type": "string", "enum": [ "team:read", "people:read", "attachments:read", "attachments:write", "leads:bulk-edit", "leads:export", "leads:read", "leads:create", "leads:edit", "leads:archive", "assignments:write", "activities:read", "activities:write", "tasks:read", "tasks:write", "imports:read", "imports:write", "scores:read", "dashboard:read", "configuration:read", "notifications:read", "notifications:write" ] }, "uniqueItems": true }, "expiresInDays": { "default": 30, "anyOf": [ { "type": "number", "const": 7 }, { "type": "number", "const": 30 }, { "type": "number", "const": 90 } ] } }, "required": [ "name", "scopes" ], "additionalProperties": false, "description": "Google-authenticated administrators only. Choose at least one unique permission scope. The raw token is returned once and is never stored in an idempotency response." }, "EmptyInput": { "type": "object", "additionalProperties": false }, "ScoringConfig": { "type": "object", "required": [ "version", "enabled", "factors" ], "properties": { "version": { "type": "integer" }, "enabled": { "type": "boolean" }, "factors": { "maxItems": 30, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,59}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "group": { "type": "string", "enum": [ "fit", "intent", "risk" ] }, "weight": { "type": "integer", "minimum": 1, "maximum": 100 }, "description": { "type": "string", "minLength": 10, "maxLength": 600 }, "enabled": { "type": "boolean" } }, "required": [ "id", "label", "group", "weight", "description", "enabled" ], "additionalProperties": false } } } }, "LeadScore": { "type": "object", "required": [ "status", "score" ], "properties": { "leadId": { "type": "string" }, "status": { "type": "string", "enum": [ "Ready", "Pending", "Processing", "Stale", "Failed", "Disabled" ] }, "score": { "type": [ "integer", "null" ], "minimum": 0, "maximum": 100 }, "factors": { "type": "array", "items": { "type": "object" } }, "coverage": { "type": "integer" }, "knownFactors": { "type": "integer" }, "totalFactors": { "type": "integer" }, "scoredAt": { "type": "string" }, "band": { "type": "string" } } }, "Dashboard": { "type": "object", "required": [ "asOf", "facts", "coverage", "trend", "stages", "tasks", "priority" ], "properties": { "asOf": { "type": "string" }, "visualization": { "type": "object", "description": "Personal grouping over authorized scanned leads only. Includes requested/effective field, label, unavailable fallback flag, availableFields and groups. At most 20 displayed groups plus Other values; group keys distinguish missing values. Normalized equality and Is empty support drill-through; aggregate/overlong-label groups are not direct filters." }, "insightMode": { "type": "string", "enum": [ "manual", "automatic" ], "description": "Workspace dashboard mode only; custom AI instructions are not exposed." }, "timezone": { "type": "string" }, "facts": { "type": "object", "additionalProperties": { "type": "number" } }, "coverage": { "type": "object" }, "trend": { "type": "array", "items": { "type": "object" } }, "stages": { "type": "array", "items": { "type": "object" } }, "tasks": { "type": "array", "items": { "type": "object" } }, "priority": { "type": "array", "items": { "type": "object" } } } }, "DashboardBrief": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string", "enum": [ "Ready", "Processing", "Unavailable" ] }, "brief": { "type": "object", "properties": { "headline": { "type": "string" }, "summary": { "type": "string" }, "insights": { "type": "array", "items": { "type": "object" } } } }, "generatedAt": { "type": "string" }, "expiresAt": { "type": "string" } } }, "LeadFilters": { "$schema": "https://json-schema.org/draft/2020-12/schema", "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "field": { "anyOf": [ { "type": "string", "enum": [ "serial", "source", "name", "phone", "email", "company", "location", "zone", "enquiryDate", "legacyStatus", "stage", "initialDiscussion", "followUp1", "followUp2", "followUp3", "followUp4", "comments", "latestComment", "assignedToUid", "lastCallOutcome", "lastContactAt", "doNotContact", "needsReview" ] }, { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" } ] }, "op": { "type": "string", "enum": [ "contains", "equals", "exact", "startsWith", "empty", "notEmpty", "before", "after" ] }, "value": { "default": "", "type": "string", "maxLength": 400 } }, "required": [ "field", "op" ], "additionalProperties": false } }, "WorkspaceSettingsPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "exportsEnabled": { "type": "boolean" }, "assignedOnly": { "type": "boolean" } }, "required": [ "expectedVersion", "exportsEnabled", "assignedOnly" ], "additionalProperties": false }, "LeadExportInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "columns": { "minItems": 1, "maxItems": 80, "type": "array", "items": { "type": "string", "maxLength": 80 }, "uniqueItems": true }, "filters": { "default": [], "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "field": { "anyOf": [ { "type": "string", "enum": [ "serial", "source", "name", "phone", "email", "company", "location", "zone", "enquiryDate", "legacyStatus", "stage", "initialDiscussion", "followUp1", "followUp2", "followUp3", "followUp4", "comments", "latestComment", "assignedToUid", "lastCallOutcome", "lastContactAt", "doNotContact", "needsReview" ] }, { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" } ] }, "op": { "type": "string", "enum": [ "contains", "equals", "exact", "startsWith", "empty", "notEmpty", "before", "after" ] }, "value": { "default": "", "type": "string", "maxLength": 400 } }, "required": [ "field", "op" ], "additionalProperties": false } }, "stage": { "type": "string", "maxLength": 100 }, "source": { "type": "string", "maxLength": 100 }, "assignedToUid": { "type": "string", "minLength": 1, "maxLength": 128 }, "search": { "type": "string", "maxLength": 200 }, "field": { "type": "string", "enum": [ "name", "company", "phone", "email", "location", "zone" ] }, "cursor": { "type": "string", "maxLength": 4000 }, "limit": { "default": 100, "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "columns" ], "additionalProperties": false }, "WorkspaceSettings": { "type": "object", "required": [ "version", "exportsEnabled", "assignedOnly" ], "properties": { "version": { "type": "integer", "minimum": 1 }, "exportsEnabled": { "type": "boolean" }, "assignedOnly": { "type": "boolean" } } }, "LeadExportPage": { "type": "object", "required": [ "columns", "rows", "nextCursor", "policyVersion", "asOf" ], "properties": { "columns": { "type": "array", "items": { "type": "object", "required": [ "key", "label" ], "properties": { "key": { "type": "string" }, "label": { "type": "string" } } } }, "rows": { "type": "array", "maxItems": 100, "items": { "type": "object", "required": [ "id", "values" ], "properties": { "id": { "type": "string" }, "values": { "type": "array", "items": { "type": [ "string", "number" ] } } } } }, "nextCursor": { "type": [ "string", "null" ] }, "scanLimited": { "type": "boolean" }, "policyVersion": { "type": "integer" }, "asOf": { "type": "string", "format": "date-time" } } }, "AISettingsPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "instructions": { "type": "string", "maxLength": 4000 }, "insightMode": { "type": "string", "enum": [ "manual", "automatic" ] } }, "required": [ "expectedVersion", "instructions" ], "additionalProperties": false }, "AISettings": { "type": "object", "required": [ "version", "instructions", "defaultInstructions", "usingDefault", "insightMode" ], "properties": { "version": { "type": "integer", "minimum": 1 }, "instructions": { "type": "string", "maxLength": 4000 }, "insightMode": { "type": "string", "enum": [ "manual", "automatic" ] }, "defaultInstructions": { "type": "string" }, "usingDefault": { "type": "boolean" } } }, "FieldOptionsPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "labels": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "phone": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "email": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "company": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "location": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "zone": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "enquiryDate": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "legacyStatus": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "initialDiscussion": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "countryCode": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "stage": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "comments": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "outcome": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "disposition": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "assignedToUid": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "lastCallOutcome": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "lastContactAt": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "doNotContact": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "needsReview": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "latestComment": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" } }, "additionalProperties": false }, "customFields": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "type": { "type": "string", "enum": [ "text", "textarea", "number", "date", "select", "checkbox" ] }, "options": { "default": [], "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": { "default": false, "type": "boolean" }, "deleted": { "default": false, "type": "boolean" } }, "required": [ "id", "label", "type" ], "additionalProperties": false } }, "hiddenFields": { "maxItems": 25, "type": "array", "items": { "type": "string", "enum": [ "source", "phone", "email", "company", "location", "zone", "legacyStatus", "initialDiscussion", "countryCode", "stage", "comments", "outcome", "disposition", "assignedToUid", "lastCallOutcome", "lastContactAt", "doNotContact", "needsReview", "latestComment", "followUp1", "followUp2", "followUp3", "followUp4" ] }, "description": "Remove standard fields from enquiry entry and configurable columns. Name and enquiryDate stay visible; at least one of phone or email must remain. Existing records and workflow controls are preserved." }, "values": { "type": "object", "properties": { "source": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "location": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "zone": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "legacyStatus": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "stage": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "outcome": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "disposition": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "countryCode": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } } }, "required": [ "source", "location", "zone", "legacyStatus", "stage", "outcome", "disposition", "countryCode" ], "additionalProperties": false } }, "required": [ "expectedVersion", "values" ], "additionalProperties": false }, "FieldOptions": { "type": "object", "required": [ "version", "values" ], "properties": { "version": { "type": "integer", "minimum": 1 }, "values": { "type": "object", "properties": { "source": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "location": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "zone": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "legacyStatus": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "stage": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "outcome": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "disposition": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "countryCode": { "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } } }, "required": [ "source", "location", "zone", "legacyStatus", "stage", "outcome", "disposition", "countryCode" ], "additionalProperties": false }, "labels": { "type": "object", "properties": { "source": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "phone": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "email": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "company": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "location": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "zone": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "enquiryDate": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "legacyStatus": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "initialDiscussion": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "countryCode": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "stage": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "comments": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "outcome": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "disposition": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "assignedToUid": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "lastCallOutcome": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "lastContactAt": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "doNotContact": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "needsReview": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" }, "latestComment": { "type": "string", "minLength": 1, "maxLength": 80, "pattern": "^[^\\r\\n\\x00-\\x1f]+$" } }, "additionalProperties": false }, "customFields": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "type": { "type": "string", "enum": [ "text", "textarea", "number", "date", "select", "checkbox" ] }, "options": { "default": [], "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": { "default": false, "type": "boolean" }, "deleted": { "default": false, "type": "boolean" } }, "required": [ "id", "label", "type" ], "additionalProperties": false } }, "hiddenFields": { "maxItems": 25, "type": "array", "items": { "type": "string", "enum": [ "source", "phone", "email", "company", "location", "zone", "legacyStatus", "initialDiscussion", "countryCode", "stage", "comments", "outcome", "disposition", "assignedToUid", "lastCallOutcome", "lastContactAt", "doNotContact", "needsReview", "latestComment", "followUp1", "followUp2", "followUp3", "followUp4" ] }, "description": "Fields removed from enquiry entry, configurable columns, filters and new reports where applicable. Name and enquiryDate cannot be hidden; keep phone or email visible. This is presentation configuration, not data erasure, authorization or removal of workflow/suppression controls." } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "requestId" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "requestId": { "type": "string" }, "details": {} } } } }, "Page": { "type": "object", "required": [ "items", "nextCursor" ], "properties": { "items": { "type": "array", "items": { "type": "object" } }, "nextCursor": { "type": [ "string", "null" ] }, "scanLimited": { "type": "boolean" } } }, "Lead": { "type": "object", "properties": { "name": { "default": "", "type": "string", "maxLength": 200 }, "phone": { "default": "", "type": "string", "maxLength": 40 }, "email": { "default": "", "anyOf": [ { "type": "string", "maxLength": 254, "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, { "type": "string", "const": "" } ] }, "company": { "default": "", "type": "string", "maxLength": 200 }, "jobTitle": { "default": "", "type": "string", "maxLength": 200 }, "source": { "default": "Direct enquiry", "type": "string", "maxLength": 200 }, "location": { "default": "", "type": "string", "maxLength": 200 }, "zone": { "default": "", "type": "string", "maxLength": 200 }, "enquiryDate": { "default": "", "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "const": "" } ] }, "stage": { "default": "New", "type": "string", "minLength": 1, "maxLength": 100 }, "comments": { "default": "", "type": "string", "maxLength": 4000 }, "initialDiscussion": { "default": "", "type": "string", "maxLength": 4000 }, "followUp1": { "default": "", "type": "string", "maxLength": 4000 }, "followUp2": { "default": "", "type": "string", "maxLength": 4000 }, "followUp3": { "default": "", "type": "string", "maxLength": 4000 }, "followUp4": { "default": "", "type": "string", "maxLength": 4000 }, "originalPhone": { "default": "", "type": "string", "maxLength": 200 }, "originalEnquiryDate": { "default": "", "type": "string", "maxLength": 100 }, "legacyStatus": { "default": "", "type": "string", "maxLength": 200 }, "serial": { "default": "", "type": "string", "maxLength": 80 }, "customFields": { "default": {}, "type": "object", "propertyNames": { "type": "string", "pattern": "^cf_[a-z0-9_]{1,60}$" }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "tags": { "default": [], "maxItems": 20, "type": "array", "items": { "type": "string", "maxLength": 40 } }, "website": { "default": "", "type": "string", "maxLength": 300 }, "countryCode": { "default": "+91", "type": "string", "pattern": "^\\+\\d{1,3}$" }, "needsReview": { "default": false, "type": "boolean" }, "id": { "type": "string" }, "version": { "type": "integer", "minimum": 0 }, "assignedToUid": { "type": [ "string", "null" ] }, "createdByUid": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "lastContactAt": { "type": [ "string", "null" ], "format": "date-time" }, "lastCallOutcome": { "type": [ "string", "null" ], "enum": [ "Connected", "No answer", "Busy", "Voicemail", "Wrong number", "Failed", null ] }, "doNotContact": { "type": "boolean" }, "suppressionReason": { "type": "string" }, "archived": { "type": "boolean" }, "archivedAt": { "type": "string", "format": "date-time", "description": "Recorded for new archives; absent on older records. Never inferred from updatedAt." } }, "required": [ "id", "name", "stage", "version", "assignedToUid", "createdAt", "updatedAt" ] }, "Task": { "type": "object", "properties": { "responsible": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "sharedLeadContext": { "type": "string" }, "canManage": { "type": "boolean" }, "canEditOwn": { "type": "boolean" }, "lead": { "type": [ "object", "null" ], "description": "Task list only: current authorized linked lead summary, independent of the loaded lead page. Null for personal reminders.", "required": [ "id", "name", "company" ], "additionalProperties": false, "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "company": { "type": "string" } } }, "title": { "type": "string", "minLength": 1, "maxLength": 250 }, "leadId": { "type": [ "string", "null" ] }, "dueAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "timezone": { "default": "Asia/Kolkata", "type": "string", "maxLength": 100 }, "kind": { "default": "outreach", "type": "string", "enum": [ "outreach", "administrative" ] }, "id": { "type": "string" }, "creatorUid": { "type": "string" }, "recipientUid": { "type": "string" }, "state": { "type": "string", "enum": [ "Pending", "Completed", "Cancelled" ] }, "version": { "type": "integer", "minimum": 0 }, "createdAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "responsible", "sharedLeadContext", "canManage", "canEditOwn", "lead", "title", "leadId", "dueAt", "timezone", "kind", "id", "creatorUid", "recipientUid", "state", "version", "createdAt", "completedAt" ] }, "AutomaticReminder": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "Pending", "Scheduled", "NeedsReview", "NoAction", "Failed", "Cancelled", "Manual", "Disabled", "Dismissed", "TaskChanged" ] }, "ownerUid": { "type": "string" }, "taskId": { "type": [ "string", "null" ] }, "message": { "type": "string" }, "dueAt": { "type": "string", "format": "date-time" }, "timezone": { "type": "string" }, "processedAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "status", "ownerUid", "taskId", "message" ] }, "Activity": { "type": "object", "properties": { "id": { "type": "string" }, "leadId": { "type": "string" }, "type": { "type": "string", "enum": [ "call", "note", "change" ] }, "outcome": { "type": "string" }, "disposition": { "type": "string" }, "notes": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "actorUid": { "type": "string" }, "revision": { "type": "integer", "minimum": 0 }, "autoReminder": { "$ref": "#/components/schemas/AutomaticReminder" }, "sourceColumn": { "type": "string" }, "sourceOrder": { "type": "integer", "minimum": 0 }, "imported": { "type": "boolean" }, "occurredAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "leadId", "type", "notes", "createdAt" ] }, "Member": { "type": "object", "properties": { "id": { "type": "string" }, "uid": { "type": "string" }, "email": { "type": "string", "format": "email" }, "name": { "type": "string" }, "role": { "type": "string", "enum": [ "Admin", "Viewer", "SDR" ] }, "scope": { "type": "string", "enum": [ "all", "assigned" ] }, "capabilities": { "type": "array", "items": { "type": "string", "enum": [ "leads:read", "leads:create", "leads:edit", "activities:write", "tasks:write", "imports:read", "imports:write", "imports:share", "members:write", "assignments:write", "hygiene:read", "hygiene:run", "hygiene:ai", "assistant:query" ] } }, "active": { "type": "boolean" }, "version": { "type": "integer", "minimum": 0 } }, "required": [ "id", "uid", "email", "name", "role", "scope", "capabilities", "active", "version" ] }, "Invitation": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": "string", "format": "email" }, "role": { "type": "string", "enum": [ "Viewer", "SDR" ] }, "scope": { "type": "string", "enum": [ "all", "assigned" ] }, "capabilities": { "type": "array", "items": { "type": "string" } }, "active": { "type": "boolean" }, "expiresAt": { "type": "string", "format": "date-time" }, "version": { "type": "integer", "minimum": 0 } }, "required": [ "id", "email", "role", "scope", "capabilities", "active", "expiresAt", "version" ] }, "Profile": { "type": "object", "properties": { "identity": { "type": "object", "properties": { "uid": { "type": "string" }, "email": { "type": "string", "format": "email" }, "name": { "type": "string" }, "photoURL": { "type": "string", "description": "Google profile photo URL when available; initials are used otherwise." } }, "required": [ "uid", "email", "name" ] }, "mode": { "type": "string", "enum": [ "live", "demo" ] }, "member": { "anyOf": [ { "$ref": "#/components/schemas/Member" }, { "type": "null" } ] }, "preferences": { "$ref": "#/components/schemas/Preferences" }, "invitation": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "role": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "id", "role", "scope" ] }, { "type": "null" } ] } }, "required": [ "identity", "mode", "member", "preferences", "invitation" ] }, "Notification": { "type": "object", "properties": { "id": { "type": "string" }, "taskId": { "type": [ "string", "null" ] }, "kind": { "type": "string", "enum": [ "task_reminder", "lead_created", "lead_assigned" ] }, "body": { "type": "string" }, "leadId": { "type": [ "string", "null" ] }, "workspaceId": { "type": "string" }, "title": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "readAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "taskId", "leadId", "workspaceId", "title", "createdAt", "readAt" ] }, "Device": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "enabled": { "type": "boolean" }, "lastSeenAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "label", "enabled" ] }, "ImportError": { "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "error": { "type": "string" } }, "required": [ "index", "error" ] }, "ImportJob": { "type": "object", "properties": { "id": { "type": "string" }, "filename": { "type": "string" }, "sheet": { "type": "string" }, "total": { "type": "integer", "minimum": 0 }, "valid": { "type": "integer", "minimum": 0 }, "invalid": { "type": "integer", "minimum": 0 }, "blank": { "type": "integer", "minimum": 0 }, "offset": { "type": "integer", "minimum": 0 }, "imported": { "type": "integer", "minimum": 0 }, "duplicates": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 }, "status": { "type": "string", "enum": [ "Preparing", "Preview", "Importing", "Blocked", "Completed", "Deleting", "DetailsDeleted" ] }, "createdByUid": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ImportError" } }, "commentCount": { "type": "integer", "minimum": 0, "description": "Nonempty comment entries in valid preview rows, before duplicate-contact skipping." }, "chunkSize": { "type": "integer", "minimum": 1, "description": "New previews use 11 rows per commit; older previews may use 25." }, "version": { "type": "integer", "minimum": 0 }, "formatVersion": { "type": "integer", "minimum": 0 }, "datasetId": { "type": "string" }, "sourceImportId": { "type": [ "string", "null" ] }, "createdByName": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" }, "configVersion": { "type": "integer", "minimum": 0 }, "planOffset": { "type": "integer", "minimum": 0 }, "reviewOffset": { "type": "integer", "minimum": 0 }, "pending": { "type": "integer", "minimum": 0 }, "updated": { "type": "integer", "minimum": 0 }, "unchanged": { "type": "integer", "minimum": 0 }, "skipped": { "type": "integer", "minimum": 0 }, "reviewedByUid": { "type": "string" }, "executedByUid": { "type": "string" }, "lastError": { "type": [ "string", "null" ] }, "planCounts": { "type": "object", "additionalProperties": { "type": "integer", "minimum": 0 } }, "detailsDeletedAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "filename", "sheet", "total", "valid", "invalid", "blank", "offset", "imported", "duplicates", "failed", "status", "createdByUid", "createdAt", "expiresAt" ] }, "ImportRow": { "type": "object", "properties": { "index": { "type": "integer", "minimum": 0 }, "sourceRow": { "type": "integer", "minimum": 0 }, "classification": { "type": "string", "enum": [ "New", "Update", "Unchanged", "Conflict", "Duplicate", "Invalid", "Restricted" ] }, "decision": { "type": "string", "enum": [ "pending", "accept", "skip" ] }, "outcome": { "type": "string", "enum": [ "Created", "Updated", "Unchanged", "Duplicate", "Skipped" ] }, "reason": { "type": "string" }, "error": { "type": "string" }, "leadId": { "type": [ "string", "null" ] }, "expectedLeadVersion": { "type": "integer", "minimum": 0 }, "initialComparison": { "type": "boolean" }, "committedAt": { "type": "string", "format": "date-time" }, "committedByUid": { "type": "string" }, "reviewedByUid": { "type": "string" }, "row": { "type": "object", "description": "Authorized parsed workbook data, including normalized matching fields. Not telemetry." }, "clearFields": { "type": "array", "items": { "type": "string" } }, "incomingFields": { "type": "array", "items": { "type": "string" } }, "mapped": { "type": "array", "items": { "type": "string" } }, "relatedSourceRows": { "type": "array", "items": { "type": "integer", "minimum": 0 } }, "candidates": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" }, "company": { "type": "string" }, "archived": { "type": "boolean" } }, "required": [ "id", "name", "phone", "email", "company", "archived" ] } }, "changes": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "current": {}, "incoming": {}, "conflict": { "type": "boolean" }, "explicitClear": { "type": "boolean" } }, "required": [ "key", "current", "incoming", "conflict" ] } }, "commentChanges": { "type": "array", "items": { "type": "object" } } }, "required": [ "index" ] }, "Summary": { "type": "object", "properties": { "total": { "type": "integer", "minimum": 0 }, "newLeads": { "type": "integer", "minimum": 0 }, "due": { "type": "integer", "minimum": 0 }, "calls": { "type": "integer", "minimum": 0 }, "connected": { "type": "integer", "minimum": 0 }, "period": { "type": "string" } }, "required": [ "total", "newLeads", "due", "calls", "connected", "period" ] }, "CallSaved": { "type": "object", "properties": { "activity": { "$ref": "#/components/schemas/Activity" }, "lead": { "$ref": "#/components/schemas/Lead" } }, "required": [ "activity", "lead" ] }, "Ok": { "type": "object", "properties": { "ok": { "type": "boolean" } }, "required": [ "ok" ] }, "PersonalAccessToken": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "prefix": { "type": "string" }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "team:read", "people:read", "attachments:read", "attachments:write", "leads:bulk-edit", "leads:export", "leads:read", "leads:create", "leads:edit", "leads:archive", "assignments:write", "activities:read", "activities:write", "tasks:read", "tasks:write", "imports:read", "imports:write", "scores:read", "dashboard:read", "configuration:read", "notifications:read", "notifications:write" ] } }, "createdAt": { "type": "string", "format": "date-time" }, "expiresAt": { "type": "string", "format": "date-time" }, "lastUsedAt": { "type": [ "string", "null" ], "format": "date-time" }, "revokedAt": { "type": [ "string", "null" ], "format": "date-time" }, "active": { "type": "boolean" } }, "required": [ "id", "name", "prefix", "scopes", "createdAt", "expiresAt", "active" ] }, "TokenCreated": { "type": "object", "properties": { "token": { "type": "string", "readOnly": true, "description": "One-time raw Bearer credential. Store securely; never put in a URL." }, "personalAccessToken": { "$ref": "#/components/schemas/PersonalAccessToken" } }, "required": [ "token", "personalAccessToken" ] }, "TokenPage": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/PersonalAccessToken" } }, "nextCursor": { "type": [ "string", "null" ] }, "availableScopes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "description": { "type": "string" }, "capability": { "type": "string" } }, "required": [ "id", "description", "capability" ] } }, "maxActiveTokens": { "type": "integer", "const": 20 } }, "required": [ "items", "nextCursor", "availableScopes", "maxActiveTokens" ] }, "ResearchSettingsPatch": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "convertedStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "failedStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "archiveReviewStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "inactivityDays": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 3650 }, { "type": "null" } ] }, "timezone": { "type": "string", "minLength": 1, "maxLength": 100 }, "indexingEnabled": { "type": "boolean" } }, "required": [ "expectedVersion", "convertedStages", "failedStages", "archiveReviewStages", "inactivityDays", "timezone", "indexingEnabled" ], "additionalProperties": false }, "ResearchVersion": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "expectedVersion": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "expectedVersion" ], "additionalProperties": false }, "ScanInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "includeArchived": { "default": false, "type": "boolean" } }, "additionalProperties": false }, "ConversationInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }, "QuestionInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "question": { "type": "string", "minLength": 3, "maxLength": 1000 } }, "required": [ "question" ], "additionalProperties": false }, "ResearchSettings": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "convertedStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "failedStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "archiveReviewStages": { "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "inactivityDays": { "anyOf": [ { "type": "integer", "minimum": 1, "maximum": 3650 }, { "type": "null" } ] }, "timezone": { "type": "string", "minLength": 1, "maxLength": 100 }, "indexingEnabled": { "type": "boolean" }, "version": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "convertedStages", "failedStages", "archiveReviewStages", "inactivityDays", "timezone", "indexingEnabled", "version" ], "additionalProperties": false }, "ResearchScan": { "type": "object", "required": [ "id", "status", "version" ], "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "Pending", "Running", "Completed", "Stale", "Deleting" ] }, "version": { "type": "integer" }, "scanned": { "type": [ "integer", "null" ] }, "findings": { "type": [ "integer", "null" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "summaryStatus": { "type": [ "string", "null" ], "enum": [ "Pending", "Completed", "Failed", null ] }, "summary": { "type": [ "object", "null" ], "properties": { "themes": { "type": "array", "items": { "type": "object", "required": [ "label", "evidence" ], "properties": { "label": { "type": "string" }, "evidence": { "type": "array", "items": { "type": "object", "required": [ "sourceId", "quote" ], "properties": { "sourceId": { "type": "string" }, "quote": { "type": "string" } } } } } } }, "sampledFindings": { "type": "integer" }, "totalFindings": { "type": "integer" } } } } }, "TeamMember": { "type": "object", "required": [ "id", "name", "role", "active", "assigned", "comments", "calls", "leadsWorked", "stageChanges", "pending", "overdue", "completed" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "role": { "type": "string" }, "active": { "type": "boolean" }, "assigned": { "type": "integer", "minimum": 0 }, "comments": { "type": "integer", "minimum": 0 }, "calls": { "type": "integer", "minimum": 0 }, "connected": { "type": "integer", "minimum": 0 }, "leadsWorked": { "type": "integer", "minimum": 0 }, "stageChanges": { "type": "integer", "minimum": 0 }, "pending": { "type": "integer", "minimum": 0 }, "overdue": { "type": "integer", "minimum": 0 }, "completed": { "type": "integer", "minimum": 0 }, "lastActivityAt": { "type": [ "string", "null" ], "format": "date-time" }, "stages": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "value": { "type": "integer" } } } } } }, "TeamSnapshot": { "type": "object", "required": [ "generatedAt", "since", "days", "timezone", "members", "trend", "unassigned", "unlistedAssigned", "limits" ], "properties": { "generatedAt": { "type": "string", "format": "date-time" }, "since": { "type": "string", "format": "date-time" }, "days": { "type": "integer", "enum": [ 7, 30, 90 ] }, "timezone": { "type": "string", "const": "UTC" }, "members": { "type": "array", "maxItems": 200, "items": { "$ref": "#/components/schemas/TeamMember" } }, "unassigned": { "type": "integer" }, "unlistedAssigned": { "type": "integer" }, "trend": { "type": "array", "maxItems": 90, "items": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "comments": { "type": "integer" }, "calls": { "type": "integer" } } } }, "limits": { "type": "object", "additionalProperties": { "type": "integer" } } } }, "TeamActivity": { "type": "object", "required": [ "id", "type", "notes", "createdAt", "lead", "revision" ], "properties": { "id": { "type": "string" }, "type": { "type": "string", "enum": [ "note", "call" ] }, "notes": { "type": "string", "maxLength": 4000 }, "outcome": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" }, "revision": { "type": "integer" }, "lead": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } } }, "LeadAssignee": { "type": "object", "required": [ "id", "name", "active" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "active": { "type": "boolean" } } }, "ResearchLead": { "type": "object", "required": [ "id" ], "properties": { "id": { "type": "string" }, "version": { "type": "integer" }, "name": { "type": "string" }, "company": { "type": "string" } } }, "ResearchFinding": { "type": "object", "required": [ "id", "kind", "count" ], "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": [ "Review", "SharedContact", "IndexReview" ] }, "count": { "type": "integer" }, "field": { "type": "string" }, "value": { "type": "string" }, "issues": { "type": "array", "items": { "type": "string" } }, "leadIds": { "type": "array", "items": { "type": "string" } }, "leads": { "type": "array", "items": { "$ref": "#/components/schemas/ResearchLead" } } } }, "AssistantConversation": { "type": "object", "required": [ "id", "version", "status" ], "properties": { "id": { "type": "string" }, "version": { "type": "integer" }, "status": { "type": "string", "enum": [ "Active", "Stale", "Deleting" ] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } } }, "AssistantAnswer": { "type": "object", "required": [ "state", "text" ], "properties": { "state": { "type": "string", "enum": [ "Grounded", "Partial", "Clarify", "Insufficient", "OutOfScope", "Unavailable" ] }, "text": { "type": "string" }, "count": { "type": "integer" }, "hasResults": { "type": "boolean" }, "resultType": { "type": "string", "enum": [ "leads", "records" ] }, "groupOverflow": { "type": "integer" }, "groups": { "type": "object", "additionalProperties": { "type": "integer" } }, "fields": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "type": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" } } } } }, "coverage": { "type": "object", "properties": { "scanned": { "type": "integer" }, "asOf": { "type": "string" }, "timezone": { "type": "string" }, "cohort": { "type": "string" }, "window": { "type": "object", "properties": { "startDate": { "type": "string" }, "endDate": { "type": "string" }, "timezone": { "type": "string" } } } } }, "themes": { "type": "array", "items": { "type": "object", "required": [ "label", "evidence" ], "properties": { "label": { "type": "string" }, "evidence": { "type": "array", "items": { "type": "object", "required": [ "sourceId", "quote" ], "properties": { "sourceId": { "type": "string" }, "quote": { "type": "string" } } } } } } }, "sources": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "leadId": { "type": "string" }, "name": { "type": "string" }, "text": { "type": "string" } } } }, "parts": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "$ref": "#/components/schemas/AssistantAnswer" }, "description": "Independent grounded answers or focused clarifications for a compound question. Result pagination uses the zero-based part index." } } }, "AssistantRequest": { "type": "object", "required": [ "id", "status" ], "properties": { "id": { "type": "string" }, "jobId": { "type": "string" }, "status": { "type": "string", "enum": [ "Pending", "Completed", "Failed", "Stale", "Cancelled" ] }, "version": { "type": "integer" }, "question": { "type": "string" }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "answer": { "$ref": "#/components/schemas/AssistantAnswer" } } }, "ResearchIndex": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "status": { "type": "string" }, "scanned": { "type": "integer" }, "pending": { "type": "integer" }, "failed": { "type": "integer" }, "note": { "type": "string" } } } } } }