"}],"body":{"mode":"raw","raw":"{\n \"name\": \"Production Key\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/api-keys"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"9263a20a-54f5-47b4-973c-b4e1139ea30b"}],"id":"59a4ffe1-3682-4942-9526-c0500473833f","_postman_id":"59a4ffe1-3682-4942-9526-c0500473833f","description":""},{"name":"admin","item":[{"name":"health","item":[{"name":"Admin Health","id":"7ea9afb2-f0d9-4528-8fb3-f7a2947be543","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/health","description":"Get system health metrics.
\nAuthentication: Requires server API key in X-API-Key header
\nNote: This endpoint uses simplified auth (server key only) since:
\n\n- It's behind Netlify password protection
\n- Returns only aggregated metrics (no PII)
\n- Admin dashboard use case
\n
\nReturns:\n - Today's report statistics (completed, failed, queued, processing)\n - Performance metrics (avg delivery time from submission to completion, fastest, slowest)\n - Error rate and recent errors\n - System status
\n","urlObject":{"path":["v1","admin","health"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"0b0d8292-9fef-444d-9525-99959a04888a","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"74362e56-6ff6-46b6-8ad7-eacabda221cb","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/health"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"7ea9afb2-f0d9-4528-8fb3-f7a2947be543"}],"id":"dc2fd233-a1b6-4ac1-9bb1-403fbecff1ef","_postman_id":"dc2fd233-a1b6-4ac1-9bb1-403fbecff1ef","description":""},{"name":"monitor","item":[{"name":"status","item":[{"name":"Get Monitor Status","id":"015181c7-884b-44fb-b65e-04ee38a88bde","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor/status","description":"Get current monitoring thresholds and last alert times.
\nAuthentication: Requires server API key
\nReturns current configuration and state for debugging.
\n","urlObject":{"path":["v1","admin","monitor","status"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"bb3bba84-696c-4868-bafd-790ca81f0191","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"e30473ef-7f04-47ff-8903-6c8eee63108a","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor/status"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"015181c7-884b-44fb-b65e-04ee38a88bde"}],"id":"8b0ca539-ba0a-46d7-b6be-b6d24ccc7961","_postman_id":"8b0ca539-ba0a-46d7-b6be-b6d24ccc7961","description":""},{"name":"Run Proactive Monitoring","id":"30008683-b56c-4bd9-b8f6-01d5488d7eaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor","description":"Run proactive monitoring checks and send alerts if thresholds exceeded.
\nAuthentication: Requires server API key in X-API-Key header
\nDesigned for: Cloud Scheduler (call every 5-10 minutes)
\nChecks performed:
\n\n- Error Rate: Alert if > 20% failures in last 10 minutes
\n- Stuck Reports: Alert if any report stuck > 45 minutes
\n- Zero Completions: Alert if no completions in 30 minutes (business hours only)
\n
\nAlert Behavior:
\n\n- 30 minute cooldown per alert type to avoid spam
\n- Alerts sent via Postmark to admin email
\n- Business hours: 9 AM - 9 PM PST
\n
\nReturns:\n - Check results with triggered status\n - Number of alerts sent\n - Number of alerts skipped (cooldown)
\nCloud Scheduler Setup:
\ngcloud scheduler jobs create http proactive-monitor \\\n --location=us-central1 \\\n --schedule=\"*/10 * * * *\" \\\n --uri=\"https://api.surmado.com/v1/admin/monitor\" \\\n --http-method=POST \\\n --headers=\"X-API-Key=sur_server_...\" \\\n --time-zone=\"America/Los_Angeles\"\n
\n","urlObject":{"path":["v1","admin","monitor"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"a4a8fb16-f977-4d33-948e-e39857e9a850","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"c0af2f79-0aa1-4e76-a463-a7ee64e9fc2e","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"string"},{"key":"Accept","value":"application/json"}],"url":"//v1/admin/monitor"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"30008683-b56c-4bd9-b8f6-01d5488d7eaa"}],"id":"ca116322-61a2-4a6d-9a3e-6e2a27ce82d8","_postman_id":"ca116322-61a2-4a6d-9a3e-6e2a27ce82d8","description":""}],"id":"95f34370-a93f-44e2-8098-9488a3ce3aec","_postman_id":"95f34370-a93f-44e2-8098-9488a3ce3aec","description":""},{"name":"profiles","item":[{"name":"{brand_slug}","item":[{"name":"metrics","item":[{"name":"Get Profile Metrics","id":"3a399531-c98c-420c-a2b8-83cffb225a62","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles/:brand_slug/metrics?tracked_only=false","description":"Get metrics and deltas for a brand.
\nLighter than full profile - excludes competitors, preferences, actions.
\nArgs:\n tracked_only: Filter to user's tracked metrics if True
\n","urlObject":{"path":["v1","profiles",":brand_slug","metrics"],"host":["/"],"query":[{"description":{"content":"Only return metrics in tracked_metrics preference
\n","type":"text/plain"},"key":"tracked_only","value":"false"}],"variable":[{"id":"2a04229d-3006-47e8-8dd9-a7eb2f96b138","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"08a32d94-be68-47ca-bc03-b642adfaeea3","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/metrics?tracked_only=false","host":["/"],"path":["v1","profiles",":brand_slug","metrics"],"query":[{"description":"Only return metrics in tracked_metrics preference","key":"tracked_only","value":"false"}],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"83c0c63e-21f6-4f61-8297-ddfbaf432020","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/metrics?tracked_only=false","host":["/"],"path":["v1","profiles",":brand_slug","metrics"],"query":[{"description":"Only return metrics in tracked_metrics preference","key":"tracked_only","value":"false"}],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"3a399531-c98c-420c-a2b8-83cffb225a62"}],"id":"e34d5b8c-2fcc-419d-b7af-99a81c1751c5","_postman_id":"e34d5b8c-2fcc-419d-b7af-99a81c1751c5","description":""},{"name":"score","item":[{"name":"Get Surmado Score","id":"76396d20-027c-4898-8e44-9fabbb736ef4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles/:brand_slug/score","description":"Get Surmado Score only (ultra-lightweight).
\nReturns minimal payload for dashboards:
\n\n- surmado_score: Current score (0-100)
\n- wow_delta: Week-over-week change
\n- trend: up/down/flat
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug","score"],"host":["/"],"query":[],"variable":[{"id":"cabf20aa-dc01-49d3-a874-29567e0252e5","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"628db935-45bc-4edf-920b-a69965fd4cd7","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/score","host":["/"],"path":["v1","profiles",":brand_slug","score"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"d74fc43c-1476-4293-ab8b-35589254ea5d","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/score","host":["/"],"path":["v1","profiles",":brand_slug","score"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"76396d20-027c-4898-8e44-9fabbb736ef4"}],"id":"e3119006-ebae-42d0-9e8b-2af00dc655c8","_postman_id":"e3119006-ebae-42d0-9e8b-2af00dc655c8","description":""},{"name":"competitors","item":[{"name":"Get Competitors","id":"2992073f-0070-41d8-aa4a-8361d09ea275","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles/:brand_slug/competitors","description":"Get competitor intelligence for a brand.
\nReturns:
\n\n- current_top: List of top competitors with visibility and gap
\n- recent_changes: Changes in competitive landscape
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug","competitors"],"host":["/"],"query":[],"variable":[{"id":"a48ebe45-c04b-4dad-a5c9-14af0edbe504","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"900b7919-e344-4342-95bb-1a729d176efd","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/competitors","host":["/"],"path":["v1","profiles",":brand_slug","competitors"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"ff478e53-7095-427b-a7e5-94df6891c25f","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/competitors","host":["/"],"path":["v1","profiles",":brand_slug","competitors"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"2992073f-0070-41d8-aa4a-8361d09ea275"}],"id":"536e05c8-4c37-493f-baa3-f9174fddd27f","_postman_id":"536e05c8-4c37-493f-baa3-f9174fddd27f","description":""},{"name":"preferences","item":[{"name":"Update Preferences","id":"3945bdc6-3f75-4846-9217-795980ae3cd6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"tracked_metrics\": null,\n \"alert_thresholds\": null,\n \"notification_email\": \"string\",\n \"monitor\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles/:brand_slug/preferences","description":"Update user preferences for a profile.
\nPreferences include:
\n\n- tracked_metrics: Which metrics to track
\n- alert_thresholds: When to send alerts
\n- notification_email: Where to send notifications
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug","preferences"],"host":["/"],"query":[],"variable":[{"id":"9ae1a9cf-e5bf-4c5d-abaf-edd9cf8108df","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"33331402-7bd6-4cce-8f2e-0547260a7ab6","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"tracked_metrics\": null,\n \"alert_thresholds\": null,\n \"notification_email\": \"string\",\n \"monitor\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/preferences","host":["/"],"path":["v1","profiles",":brand_slug","preferences"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"f496635d-f1bc-4de5-ab8d-d9b6baf628aa","name":"Validation Error","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"tracked_metrics\": null,\n \"alert_thresholds\": null,\n \"notification_email\": \"string\",\n \"monitor\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/preferences","host":["/"],"path":["v1","profiles",":brand_slug","preferences"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"3945bdc6-3f75-4846-9217-795980ae3cd6"}],"id":"11b88b05-5cf3-4a74-9ca7-6286bcf25eeb","_postman_id":"11b88b05-5cf3-4a74-9ca7-6286bcf25eeb","description":""},{"name":"actions","item":[{"name":"{action_id}","item":[{"name":"complete","item":[{"name":"Complete Action","id":"fd4e1164-de8d-4f3a-8099-9f45d672dcf0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles/:brand_slug/actions/:action_id/complete","description":"Mark action as completed and capture T1 metrics.
\nCaptures T1 metrics (current state at completion) for impact analysis.
\nEnables calculating:
\n\n- Immediate impact: T1 - T0 (metrics at completion vs recommendation)
\n- Delayed impact: T2 - T0 (measured later vs recommendation)
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug","actions",":action_id","complete"],"host":["/"],"query":[],"variable":[{"id":"3eabed1b-5e76-4042-8efe-6d47d5a34504","type":"any","value":"string","key":"brand_slug"},{"id":"a9ad7889-f1d4-470f-acd1-0c9dabf7f406","type":"any","value":"string","key":"action_id"}]}},"response":[{"id":"f03752a6-4efe-4193-8dbd-63b0dfad160a","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/actions/:action_id/complete","host":["/"],"path":["v1","profiles",":brand_slug","actions",":action_id","complete"],"variable":[{"key":"brand_slug","value":"string"},{"key":"action_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"8593b21e-26aa-48c3-8d17-074d3f91d6c1","name":"Validation Error","originalRequest":{"method":"PUT","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug/actions/:action_id/complete","host":["/"],"path":["v1","profiles",":brand_slug","actions",":action_id","complete"],"variable":[{"key":"brand_slug","value":"string"},{"key":"action_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"fd4e1164-de8d-4f3a-8099-9f45d672dcf0"}],"id":"a7f7a714-a209-4005-a41f-f2cc6d988e0a","_postman_id":"a7f7a714-a209-4005-a41f-f2cc6d988e0a","description":""},{"name":"dismiss","item":[{"name":"Dismiss Action","id":"028d8e43-6cc4-4c3a-a48b-c2dff466615c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"string\",\n \"comment\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles/:brand_slug/actions/:action_id/dismiss","description":"Dismiss action with reason.
\nDismissal provides negative signal for ML models - knowing what users\nWON'T do is as important as what they will.
\nReasons:
\n\n- too_technical: Beyond user's technical capability
\n- too_time_consuming: Not worth the time investment
\n- already_done: Action was already completed
\n- not_relevant: Doesn't apply to their situation
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug","actions",":action_id","dismiss"],"host":["/"],"query":[],"variable":[{"id":"1e222189-718b-4fb7-b978-c9ae446d8a62","type":"any","value":"string","key":"brand_slug"},{"id":"69e05497-b090-4d63-bd6b-2e412b4e77be","type":"any","value":"string","key":"action_id"}]}},"response":[{"id":"59a1d2d4-2272-4f9e-9d5b-7928655aaf96","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"reason\": \"string\",\n \"comment\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/actions/:action_id/dismiss","host":["/"],"path":["v1","profiles",":brand_slug","actions",":action_id","dismiss"],"variable":[{"key":"brand_slug","value":"string"},{"key":"action_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"9c313689-c2c7-4036-a236-34393cf72879","name":"Validation Error","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"reason\": \"string\",\n \"comment\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/actions/:action_id/dismiss","host":["/"],"path":["v1","profiles",":brand_slug","actions",":action_id","dismiss"],"variable":[{"key":"brand_slug","value":"string"},{"key":"action_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"028d8e43-6cc4-4c3a-a48b-c2dff466615c"}],"id":"e942fdd9-d08b-4ed6-b140-180f86386415","_postman_id":"e942fdd9-d08b-4ed6-b140-180f86386415","description":""}],"id":"ac4fb1f1-99be-445f-aa2a-d7e7e10382e3","_postman_id":"ac4fb1f1-99be-445f-aa2a-d7e7e10382e3","description":""}],"id":"568f29e5-fb18-423a-b619-408b1851cd16","_postman_id":"568f29e5-fb18-423a-b619-408b1851cd16","description":""},{"name":"brand-context","item":[{"name":"Update Brand Context","id":"fa34d82f-efed-4cad-8f80-ee1794a1c8be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": \"small\",\n \"brand_story\": \"string\",\n \"personas\": null,\n \"competitors\": null,\n \"alternative_solutions\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": \"string\",\n \"customer_profile\": null,\n \"customer_problems\": \"string\",\n \"geographic_focus\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles/:brand_slug/brand-context","description":"Update brand_context for an existing profile.
\nUse to correct or update brand information after initial creation.
\n","urlObject":{"path":["v1","profiles",":brand_slug","brand-context"],"host":["/"],"query":[],"variable":[{"id":"27db6c64-f435-4210-848d-af374f94c795","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"3eb42e60-bedb-43dc-acff-6d83975f0b93","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": \"small\",\n \"brand_story\": \"string\",\n \"personas\": null,\n \"competitors\": null,\n \"alternative_solutions\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": \"string\",\n \"customer_profile\": null,\n \"customer_problems\": \"string\",\n \"geographic_focus\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/brand-context","host":["/"],"path":["v1","profiles",":brand_slug","brand-context"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"a5ce9d7e-bee2-43f1-a99d-7a2c5de8e1b8","name":"Validation Error","originalRequest":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": \"small\",\n \"brand_story\": \"string\",\n \"personas\": null,\n \"competitors\": null,\n \"alternative_solutions\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": \"string\",\n \"customer_profile\": null,\n \"customer_problems\": \"string\",\n \"geographic_focus\": \"string\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//v1/profiles/:brand_slug/brand-context","host":["/"],"path":["v1","profiles",":brand_slug","brand-context"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"fa34d82f-efed-4cad-8f80-ee1794a1c8be"}],"id":"7fb6a4b6-155b-4f67-9a32-9c85d456225a","_postman_id":"7fb6a4b6-155b-4f67-9a32-9c85d456225a","description":""},{"name":"Get Profile","id":"97d62348-deb3-4bd9-90f8-e0b8742efbc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles/:brand_slug","description":"Get complete profile for a brand.
\nReturns all profile data including:
\n\n- Current metrics (Signal, Scan, Solutions, Monitor)
\n- Deltas (WoW, MoM, YoY)
\n- Brand context
\n- Competitors
\n- Preferences
\n- Actions history
\n
\n","urlObject":{"path":["v1","profiles",":brand_slug"],"host":["/"],"query":[],"variable":[{"id":"75aa0e7a-5d9c-4d38-a5c0-015a234c856c","type":"any","value":"string","key":"brand_slug"}]}},"response":[{"id":"62596464-d8f0-45a5-9237-b0aa3a3580f1","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug","host":["/"],"path":["v1","profiles",":brand_slug"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"69f21522-4fd8-4cdc-9cff-3723867891dc","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles/:brand_slug","host":["/"],"path":["v1","profiles",":brand_slug"],"variable":[{"key":"brand_slug","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"97d62348-deb3-4bd9-90f8-e0b8742efbc6"}],"id":"8394c294-44c5-40fd-840e-ea90c1105116","_postman_id":"8394c294-44c5-40fd-840e-ea90c1105116","description":""},{"name":"Create Profile","id":"88225b18-1c54-409e-b945-2ae8aee9f41d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_context\": {\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": null,\n \"brand_story\": \"string\",\n \"personas\": {\n \"key_0\": {\n \"slug\": \"string\",\n \"label\": \"string\",\n \"persona\": \"string\",\n \"pain_points\": null,\n \"location\": \"string\",\n \"competitors\": [\n \"string\",\n \"string\"\n ],\n \"alternatives\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"1990-08-08T09:28:39.693Z\",\n \"updated_at\": null,\n \"created_by\": \"string\",\n \"last_updated_by\": \"string\"\n }\n },\n \"competitors\": null,\n \"alternative_solutions\": \"string\",\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": null,\n \"customer_profile\": \"string\",\n \"customer_problems\": null,\n \"geographic_focus\": null\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles","description":"Create a new brand profile skeleton.
\nCreates profile with brand_context BEFORE running reports.\nEnables auto-fill across products and prevents race conditions.
\nReturns:\n brand_slug: Generated brand identifier\n brand_name: Display name\n message: Success message
\n","urlObject":{"path":["v1","profiles"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"b5e2c5f2-2dbc-45fc-9b75-5280ef7afeb5","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_context\": {\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": null,\n \"brand_story\": \"string\",\n \"personas\": {\n \"key_0\": {\n \"slug\": \"string\",\n \"label\": \"string\",\n \"persona\": \"string\",\n \"pain_points\": null,\n \"location\": \"string\",\n \"competitors\": [\n \"string\",\n \"string\"\n ],\n \"alternatives\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"1990-08-08T09:28:39.693Z\",\n \"updated_at\": null,\n \"created_by\": \"string\",\n \"last_updated_by\": \"string\"\n }\n },\n \"competitors\": null,\n \"alternative_solutions\": \"string\",\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": null,\n \"customer_profile\": \"string\",\n \"customer_problems\": null,\n \"geographic_focus\": null\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"b08e76b8-ee63-4b2a-b2ed-d6e87c811511","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_context\": {\n \"brand_name\": \"string\",\n \"website\": \"string\",\n \"industry\": \"string\",\n \"business_scale\": null,\n \"brand_story\": \"string\",\n \"personas\": {\n \"key_0\": {\n \"slug\": \"string\",\n \"label\": \"string\",\n \"persona\": \"string\",\n \"pain_points\": null,\n \"location\": \"string\",\n \"competitors\": [\n \"string\",\n \"string\"\n ],\n \"alternatives\": null,\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"created_at\": \"1990-08-08T09:28:39.693Z\",\n \"updated_at\": null,\n \"created_by\": \"string\",\n \"last_updated_by\": \"string\"\n }\n },\n \"competitors\": null,\n \"alternative_solutions\": \"string\",\n \"keywords\": [\n \"string\",\n \"string\"\n ],\n \"white_label_agency\": \"string\",\n \"last_updated_by\": null,\n \"last_updated_at\": null,\n \"value_proposition\": null,\n \"customer_profile\": \"string\",\n \"customer_problems\": null,\n \"geographic_focus\": null\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/profiles"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"88225b18-1c54-409e-b945-2ae8aee9f41d"},{"name":"List Profiles","id":"aa5183b5-c99e-4016-b6ab-b8a65927ec91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/profiles?limit=50","description":"List all profiles for the authenticated organization.
\nReturns summary of each profile (not full data).
\n","urlObject":{"path":["v1","profiles"],"host":["/"],"query":[{"description":{"content":"Maximum profiles to return
\n","type":"text/plain"},"key":"limit","value":"50"}],"variable":[]}},"response":[{"id":"014d8f2f-adfa-4ed8-88e1-7b9cc2ddc42b","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles?limit=50","host":["/"],"path":["v1","profiles"],"query":[{"description":"Maximum profiles to return","key":"limit","value":"50"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"e73f6737-2f8c-4b3d-a561-f543209b50da","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/profiles?limit=50","host":["/"],"path":["v1","profiles"],"query":[{"description":"Maximum profiles to return","key":"limit","value":"50"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"aa5183b5-c99e-4016-b6ab-b8a65927ec91"}],"id":"b6ebc056-8ece-4892-8f60-574127784543","_postman_id":"b6ebc056-8ece-4892-8f60-574127784543","description":""},{"name":"organizations","item":[{"name":"{org_id}","item":[{"name":"profiles","item":[{"name":"List Org Profiles","id":"86614f71-4997-4de3-aa15-46cac457e47c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/organizations/:org_id/profiles?limit=50","description":"List all profiles for an organization.
\nReturns summary of each profile (not full data).
\nNote: org_id in path must match authenticated org.
\n","urlObject":{"path":["v1","organizations",":org_id","profiles"],"host":["/"],"query":[{"description":{"content":"Maximum profiles to return
\n","type":"text/plain"},"key":"limit","value":"50"}],"variable":[{"id":"8242f5b4-e337-494f-8c9d-716e1de632bd","type":"any","value":"string","key":"org_id"}]}},"response":[{"id":"78ec4d3e-4a6f-4054-9f16-105bb80b4121","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/organizations/:org_id/profiles?limit=50","host":["/"],"path":["v1","organizations",":org_id","profiles"],"query":[{"description":"Maximum profiles to return","key":"limit","value":"50"}],"variable":[{"key":"org_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"509e81ea-ce00-4afa-b82d-e5e688c1baa7","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/organizations/:org_id/profiles?limit=50","host":["/"],"path":["v1","organizations",":org_id","profiles"],"query":[{"description":"Maximum profiles to return","key":"limit","value":"50"}],"variable":[{"key":"org_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"86614f71-4997-4de3-aa15-46cac457e47c"}],"id":"49c473af-3dbb-48d0-ab4f-ccc58ee91096","_postman_id":"49c473af-3dbb-48d0-ab4f-ccc58ee91096","description":""},{"name":"brands","item":[{"name":"search","item":[{"name":"Search Brands","id":"1785cdf0-b8fd-4dd2-8f65-98e68994fc32","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/organizations/:org_id/brands/search?q=string&limit=10","description":"Search brands by name prefix for autocomplete.
\nUsed by forms to find existing brands.
\nNote: org_id in path must match authenticated org.
\n","urlObject":{"path":["v1","organizations",":org_id","brands","search"],"host":["/"],"query":[{"description":{"content":"Search query
\n","type":"text/plain"},"key":"q","value":"string"},{"description":{"content":"Maximum results
\n","type":"text/plain"},"key":"limit","value":"10"}],"variable":[{"id":"c5d0099d-3ef8-4177-ab22-59932e5de83f","type":"any","value":"string","key":"org_id"}]}},"response":[{"id":"08adc951-3b3b-46c5-af5e-f4277f963e0a","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/organizations/:org_id/brands/search?q=string&limit=10","host":["/"],"path":["v1","organizations",":org_id","brands","search"],"query":[{"description":"Search query","key":"q","value":"string"},{"description":"Maximum results","key":"limit","value":"10"}],"variable":[{"key":"org_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"99fe2044-8c89-484f-a84c-7bdcbaa234b2","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//v1/organizations/:org_id/brands/search?q=string&limit=10","host":["/"],"path":["v1","organizations",":org_id","brands","search"],"query":[{"description":"Search query","key":"q","value":"string"},{"description":"Maximum results","key":"limit","value":"10"}],"variable":[{"key":"org_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"1785cdf0-b8fd-4dd2-8f65-98e68994fc32"}],"id":"29ac3f42-5962-4095-a4cb-963d6038f9ac","_postman_id":"29ac3f42-5962-4095-a4cb-963d6038f9ac","description":""}],"id":"e6cc5815-8d1d-48a1-b580-376133abebe4","_postman_id":"e6cc5815-8d1d-48a1-b580-376133abebe4","description":""}],"id":"aff6d1ad-e9bc-4b82-9bb9-ea6e45a372a3","_postman_id":"aff6d1ad-e9bc-4b82-9bb9-ea6e45a372a3","description":""}],"id":"b1a4caa3-361d-4b39-a0da-9b00f93b8392","_postman_id":"b1a4caa3-361d-4b39-a0da-9b00f93b8392","description":""},{"name":"brands","item":[{"name":"ensure","item":[{"name":"Ensure Brand","id":"2fb2cf78-adc5-497d-926a-a80918fce570","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/ensure","description":"Create or get brand - never fails with 409.
\nPerfect for automation tools (Zapier/Make/n8n) where you just want\nto ensure a brand exists without handling conflicts.
\nScoped per organization - same brand_name in different orgs creates\nseparate profiles.
\nReturns:\n - created: true if brand was just created\n - created: false if brand already existed
\n","urlObject":{"path":["v1","brands","ensure"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"66ae34bc-2dcb-40ef-a120-86b134ddca3d","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/ensure"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"brand_name\": \"Veterans Moving America\",\n \"brand_slug\": \"veterans_moving_america\",\n \"created\": true,\n \"created_at\": \"2025-11-15T10:00:00Z\"\n}"},{"id":"38935724-8938-4f0a-92c3-4a93ff130a80","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/ensure"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"2fb2cf78-adc5-497d-926a-a80918fce570"}],"id":"c5bd93e6-faa8-40bb-8644-0a4d4d1f8768","_postman_id":"c5bd93e6-faa8-40bb-8644-0a4d4d1f8768","description":""},{"name":"List Brands","id":"98ed04db-6c61-477b-9943-725ba8eab65f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/brands/","description":"List all brand profiles for this organization.
\nReturns brands sorted by creation date (newest first).
\n","urlObject":{"path":["v1","brands",""],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"80431c48-e1ad-46c1-bda8-d80d04bccd91","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":"//v1/brands/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"brands\": [\n {\n \"brand_name\": \"Veterans Moving America\",\n \"brand_slug\": \"veterans_moving_america\",\n \"created_at\": \"2025-11-15T10:00:00Z\"\n }\n ]\n}"}],"_postman_id":"98ed04db-6c61-477b-9943-725ba8eab65f"},{"name":"Create Brand","id":"cc7a0da5-9efc-42a5-b25c-84c0696ad33d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/","description":"Create a new brand profile for this organization.
\nBrand slugs are generated from brand names:
\n\n- \"Veterans Moving America\" → \"veterans_moving_america\"
\n- \"Acme Corp\" → \"acme_corp\"
\n
\nIf a brand with the same slug already exists, returns 409.
\n","urlObject":{"path":["v1","brands",""],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"e5dc2d82-3622-48a0-abb3-2a04a9f5d87e","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"brand_name\": \"Veterans Moving America\",\n \"brand_slug\": \"veterans_moving_america\",\n \"created_at\": \"2025-11-15T10:00:00Z\"\n}"},{"id":"79dc1f41-edb0-4d72-9b78-492c86b2b1aa","name":"Brand already exists","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"brand_slug\": \"veterans_moving_america\",\n \"error\": \"brand_exists\",\n \"message\": \"Brand 'Veterans Moving America' already exists. Please select it from your brands list.\"\n}"},{"id":"2a00114c-fcb4-42ad-8c9a-deb34020024e","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Veterans Moving America\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/brands/"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"cc7a0da5-9efc-42a5-b25c-84c0696ad33d"}],"id":"a4d46b3d-05e9-4b11-b1d6-791b30b6a2e7","_postman_id":"a4d46b3d-05e9-4b11-b1d6-791b30b6a2e7","description":""},{"name":"onboarding","item":[{"name":"status","item":[{"name":"Get Onboarding Status","id":"b470a100-5cb2-4033-a07c-17a7049b35a4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//v1/onboarding/status","description":"Check if organization has completed onboarding.
\nUsed by frontend to determine routing:
\n\n- has_completed_onboarding: false → redirect to wizard
\n- has_completed_onboarding: true → show dashboard
\n
\nReference: DATA_CONTRACT.md § Zone 0: Onboarding Gate Pattern
\n","urlObject":{"path":["v1","onboarding","status"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"b29a17d6-96a0-4405-a861-c671e6d30a64","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":"//v1/onboarding/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"has_completed_onboarding\": true,\n \"onboarding_completed_at\": null,\n \"is_agency\": true,\n \"agency_name\": \"string\"\n}"}],"_postman_id":"b470a100-5cb2-4033-a07c-17a7049b35a4"}],"id":"441b1d9e-a78b-4804-ba2b-1be170eb95d5","_postman_id":"441b1d9e-a78b-4804-ba2b-1be170eb95d5","description":""},{"name":"complete","item":[{"name":"Complete Onboarding","id":"4c030344-d7a6-42db-b1ee-706ce3e85ba4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Acme Corp\",\n \"business_scale\": \"medium\",\n \"competitors\": [\n \"Competitor A\",\n \"Competitor B\"\n ],\n \"industry\": \"B2B SaaS\",\n \"is_agency\": false,\n \"location\": \"United States\",\n \"pain_points\": \"Integration complexity, slow deployments\",\n \"persona\": \"CTOs at mid-market companies looking for developer tools\",\n \"website\": \"https://acme.com\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/complete","description":"Complete onboarding wizard with atomic write to Zone 0 + Zone 2.
\nThis endpoint:
\n\n- Updates org doc with Zone 0 fields (is_agency, has_completed_onboarding)
\n- Creates profile with Zone 1 fields (brand_slug, brand_name)
\n- Populates Zone 2 (brand_context with first persona)
\n
\nAll writes happen in a single Firestore transaction for atomicity.
\nReference: DATA_CONTRACT.md § Zone 0, Zone 2
\n","urlObject":{"path":["v1","onboarding","complete"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"6a424bc6-7a35-40a3-8aca-4f7faea2caab","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Acme Corp\",\n \"business_scale\": \"medium\",\n \"competitors\": [\n \"Competitor A\",\n \"Competitor B\"\n ],\n \"industry\": \"B2B SaaS\",\n \"is_agency\": false,\n \"location\": \"United States\",\n \"pain_points\": \"Integration complexity, slow deployments\",\n \"persona\": \"CTOs at mid-market companies looking for developer tools\",\n \"website\": \"https://acme.com\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/complete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"brand_slug\": \"string\",\n \"persona_slug\": \"string\",\n \"message\": \"string\"\n}"},{"id":"75f396db-c69c-47f4-aa38-25a422bfac50","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_name\": \"Acme Corp\",\n \"business_scale\": \"medium\",\n \"competitors\": [\n \"Competitor A\",\n \"Competitor B\"\n ],\n \"industry\": \"B2B SaaS\",\n \"is_agency\": false,\n \"location\": \"United States\",\n \"pain_points\": \"Integration complexity, slow deployments\",\n \"persona\": \"CTOs at mid-market companies looking for developer tools\",\n \"website\": \"https://acme.com\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/complete"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"4c030344-d7a6-42db-b1ee-706ce3e85ba4"}],"id":"ba6a6f8d-c05b-4cc9-bf67-f6c0fe8c26a8","_postman_id":"ba6a6f8d-c05b-4cc9-bf67-f6c0fe8c26a8","description":""},{"name":"run-complete-suite","item":[{"name":"Run Complete Suite","id":"7b4025d2-ac3f-4d34-afc3-76fa1f2d3bbf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"acme_corp\",\n \"email\": \"cto@acme.com\",\n \"persona_slug\": \"us-ctos-a3f2b1\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/run-complete-suite","description":"Run the complete report suite: Scan Pro + Signal Pro + Solutions Pro.
\nCredit breakdown:
\n\n- Scan Pro: 2 credits
\n- Signal Pro: 2 credits
\n- Solutions Pro: 2 credits (auto-triggered when Signal completes)
\n- Total: 6 credits
\n
\nThis endpoint loads the brand profile and persona, then delegates to the\n/v1/reports/bundle endpoint to create all three reports atomically.
\n","urlObject":{"path":["v1","onboarding","run-complete-suite"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"ae324a09-6b6f-45a7-9199-42e75bb8675f","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"acme_corp\",\n \"email\": \"cto@acme.com\",\n \"persona_slug\": \"us-ctos-a3f2b1\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/run-complete-suite"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"bundle_id\": \"string\",\n \"credits_used\": 6064,\n \"credits_remaining\": 5580,\n \"reports\": {}\n}"},{"id":"acf2a5b5-54ba-4b26-9ee9-eec17753b51e","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"acme_corp\",\n \"email\": \"cto@acme.com\",\n \"persona_slug\": \"us-ctos-a3f2b1\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//v1/onboarding/run-complete-suite"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"7b4025d2-ac3f-4d34-afc3-76fa1f2d3bbf"}],"id":"56ee9599-043b-4e87-902a-fc151f9d1970","_postman_id":"56ee9599-043b-4e87-902a-fc151f9d1970","description":""}],"id":"b8b0c9bb-ff2c-48a3-b0b8-85042570b08c","_postman_id":"b8b0c9bb-ff2c-48a3-b0b8-85042570b08c","description":""}],"id":"c1047f6f-8ea1-4b31-ac2e-a63c3a2b5c5e","_postman_id":"c1047f6f-8ea1-4b31-ac2e-a63c3a2b5c5e","description":""},{"name":"internal","item":[{"name":"process-report","item":[{"name":"Process Report","id":"333ce4ef-0e83-4d62-8a88-f16bbbd2c4a6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-internal-secret","value":"string"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//internal/process-report","description":"Internal endpoint called by Cloud Tasks to process queued reports.
\nThis endpoint:
\n\n- Validates internal secret (prevents unauthorized access)
\n- Validates payload structure
\n- Updates report status to 'processing'
\n- Dispatches to appropriate Cloud Run service
\n- Returns success (Cloud Tasks marks as complete)
\n- On failure, raises 500 (Cloud Tasks retries automatically)
\n
\nArgs:\n payload: Task payload with report details\n x_internal_secret: Internal authentication secret
\nReturns:\n Success response with report_id
\nRaises:\n HTTPException 401: Invalid internal secret\n HTTPException 400: Invalid/malformed payload\n HTTPException 500: Processing failed (triggers Cloud Tasks retry)
\n","urlObject":{"path":["internal","process-report"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"522b4228-4169-4c8f-b2e9-225ba0ddb3ce","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"x-internal-secret","value":"string"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//internal/process-report"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"aad7a555-f4cd-4c05-a5d0-9e649a40095e","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"x-internal-secret","value":"string"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//internal/process-report"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"333ce4ef-0e83-4d62-8a88-f16bbbd2c4a6"}],"id":"5c123a13-1422-454e-8788-4b9c93cd71e2","_postman_id":"5c123a13-1422-454e-8788-4b9c93cd71e2","description":""},{"name":"health","item":[{"name":"Internal Health","id":"891cc71f-f0b1-494d-8d39-aa69c74ddd2b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//internal/health","description":"Internal health check endpoint.\nUseful for debugging Cloud Tasks connectivity.
\n","urlObject":{"path":["internal","health"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"eefacf6f-47f4-4cbc-8e41-4c790993a741","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//internal/health"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"891cc71f-f0b1-494d-8d39-aa69c74ddd2b"}],"id":"9a605d30-3430-46b6-b9a0-7670acda5699","_postman_id":"9a605d30-3430-46b6-b9a0-7670acda5699","description":""}],"id":"84638fd0-c4ec-40a7-b2c3-fadc351214bf","_postman_id":"84638fd0-c4ec-40a7-b2c3-fadc351214bf","description":""},{"name":"agents","item":[{"name":"v1","item":[{"name":"threads","item":[{"name":"{thread_id}","item":[{"name":"messages","item":[{"name":"Add Message","id":"f6b36881-b13f-4bca-80da-2ba94a9b1a15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"content\": \"string\",\n \"role\": \"user\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/threads/:thread_id/messages","description":"Add a message to thread, return updated context for LLM.
\n","urlObject":{"path":["agents","v1","threads",":thread_id","messages"],"host":["/"],"query":[],"variable":[{"id":"e3a0dc08-98cf-4a9d-9e66-30143f7558cf","type":"any","value":"string","key":"thread_id"}]}},"response":[{"id":"cd9397ad-598b-4dfd-82d3-67d459eb9cc0","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"content\": \"string\",\n \"role\": \"user\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//agents/v1/threads/:thread_id/messages","host":["/"],"path":["agents","v1","threads",":thread_id","messages"],"variable":[{"key":"thread_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"message_id\": \"string\",\n \"thread_id\": \"string\",\n \"messages\": [],\n \"brand_context\": {},\n \"recent_reports\": [],\n \"credits_remaining\": 4135,\n \"intel\": null\n}"},{"id":"9882211d-2117-4ddd-83a9-5eb62164dc22","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"content\": \"string\",\n \"role\": \"user\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":{"raw":"//agents/v1/threads/:thread_id/messages","host":["/"],"path":["agents","v1","threads",":thread_id","messages"],"variable":[{"key":"thread_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"f6b36881-b13f-4bca-80da-2ba94a9b1a15"}],"id":"ae45c30f-c38f-4aef-a5ea-3405bc7a2e1f","_postman_id":"ae45c30f-c38f-4aef-a5ea-3405bc7a2e1f","description":""},{"name":"Get Thread","id":"1eb7d410-6d03-4d8c-9a4f-681bfe1630f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"//agents/v1/threads/:thread_id","description":"Get thread with full context (for reconnection/refresh).
\n","urlObject":{"path":["agents","v1","threads",":thread_id"],"host":["/"],"query":[],"variable":[{"id":"222aad4b-5743-4e61-947a-d589d79d939f","type":"any","value":"string","key":"thread_id"}]}},"response":[{"id":"74b16eb6-337f-4581-b5e8-62c1bcf50069","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//agents/v1/threads/:thread_id","host":["/"],"path":["agents","v1","threads",":thread_id"],"variable":[{"key":"thread_id","value":"string"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"thread_id\": \"string\",\n \"brand_slug\": \"string\",\n \"messages\": [],\n \"brand_context\": {},\n \"recent_reports\": [],\n \"credits_remaining\": 1930,\n \"created_at\": \"string\",\n \"intel\": null\n}"},{"id":"a1222172-424b-4b84-9460-fcd5ff85ce30","name":"Validation Error","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"url":{"raw":"//agents/v1/threads/:thread_id","host":["/"],"path":["agents","v1","threads",":thread_id"],"variable":[{"key":"thread_id","value":"string"}]}},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"1eb7d410-6d03-4d8c-9a4f-681bfe1630f1"}],"id":"b0ffd1c7-9465-4f0e-bb50-164ee330ec6d","_postman_id":"b0ffd1c7-9465-4f0e-bb50-164ee330ec6d","description":""},{"name":"Create Thread","id":"0b4c8f07-a011-4262-acd7-92018dc7271d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"report_id\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/threads","description":"Create a new conversation thread for a brand.
\n","urlObject":{"path":["agents","v1","threads"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"99330854-7974-468a-9f1e-fbda88c16999","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"report_id\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/threads"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"thread_id\": \"string\",\n \"brand_slug\": \"string\",\n \"messages\": [],\n \"brand_context\": {},\n \"recent_reports\": [],\n \"credits_remaining\": 1930,\n \"created_at\": \"string\",\n \"intel\": null\n}"},{"id":"2a6f4d6b-fdc7-41dc-9ff7-b06e4191d6da","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"report_id\": null\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/threads"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"0b4c8f07-a011-4262-acd7-92018dc7271d"}],"id":"fa942377-83f2-4227-ba5e-69360b2d9ac6","_postman_id":"fa942377-83f2-4227-ba5e-69360b2d9ac6","description":""},{"name":"reports","item":[{"name":"query","item":[{"name":"Query Reports","id":"ba63ef72-9320-4a52-a60a-8124108c0896","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{bearerToken}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"product\": \"string\",\n \"days_back\": 30,\n \"limit\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/reports/query","description":"Query historical reports with flexible filters.
\nUsed by Kibo's function calling to fetch older reports when users ask about\ntrends, historical comparisons, or want to see more reports beyond the\ndefault 2 per product that are always in context.
\nReturns reports with the same rich intelligence extraction as the default context.
\n","urlObject":{"path":["agents","v1","reports","query"],"host":["/"],"query":[],"variable":[]}},"response":[{"id":"d3491156-7410-43ad-b766-9d3db6653865","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"product\": \"string\",\n \"days_back\": 30,\n \"limit\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/reports/query"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"brand_slug\": \"string\",\n \"reports\": [],\n \"query\": {}\n}"},{"id":"9d5e4a54-e862-4502-b1fc-8bdbbebddc23","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: bearer","key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n \"brand_slug\": \"string\",\n \"product\": \"string\",\n \"days_back\": 30,\n \"limit\": 5\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"//agents/v1/reports/query"},"status":"Unprocessable Entity (WebDAV) (RFC 4918)","code":422,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": [\n {\n \"loc\": [\n 3667,\n 9168\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n },\n {\n \"loc\": [\n 6668,\n 3714\n ],\n \"msg\": \"string\",\n \"type\": \"string\"\n }\n ]\n}"}],"_postman_id":"ba63ef72-9320-4a52-a60a-8124108c0896"}],"id":"d9ca7692-4313-4c70-8e8b-4f084309bd6a","_postman_id":"d9ca7692-4313-4c70-8e8b-4f084309bd6a","description":""}],"id":"d25b580b-63a5-4f95-bf33-f6f73ded4282","_postman_id":"d25b580b-63a5-4f95-bf33-f6f73ded4282","description":""}],"id":"c45452be-1ca5-4471-8d99-60f0721b96a9","_postman_id":"c45452be-1ca5-4471-8d99-60f0721b96a9","description":""}],"id":"5686fca8-c79e-419b-9ff4-e86b0da55bfa","_postman_id":"5686fca8-c79e-419b-9ff4-e86b0da55bfa","description":""}],"variable":[{"key":"baseUrl","value":"/"}]}