{"openapi":"3.1.0","info":{"title":"POST /api/v1/businesses/nav-preferences/suggest","version":"1.0.0","description":"AI-suggest which nav items to hide"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/businesses/nav-preferences/suggest":{"post":{"tags":["businesses"],"summary":"AI-suggest which nav items to hide","description":"Given a business description and the hideable nav catalog, returns a proposed set of items to hide (with reasons) plus a one-line profile. Proposal only — nothing is saved; apply via PUT /nav-preferences.","operationId":"suggest_nav_preferences_api_v1_businesses_nav_preferences_suggest_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NavSuggestRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope_NavSuggestResponse_"}}}},"400":{"description":"Bad Request - Invalid input","content":{"application/json":{"example":{"detail":"Invalid request parameters"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"example":{"detail":"Internal server error"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"NavCatalogItem":{"properties":{"id":{"type":"string","title":"Id","description":"Stable hideable id, e.g. 'workspace:inventory'"},"label":{"type":"string","title":"Label","description":"Human label","default":""},"description":{"type":"string","title":"Description","description":"What lives here","default":""},"feature_tags":{"items":{"type":"string"},"type":"array","title":"Feature Tags","description":"Capability tags that help the model match"}},"type":"object","required":["id"],"title":"NavCatalogItem","description":"A hideable nav item the client offers the model to reason about."},"NavSuggestHidden":{"properties":{"id":{"type":"string","title":"Id"},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","required":["id"],"title":"NavSuggestHidden","description":"One suggested item to hide, with a short rationale."},"NavSuggestRequest":{"properties":{"description":{"type":"string","maxLength":2000,"minLength":1,"title":"Description","description":"Free-text business description"},"items":{"items":{"$ref":"#/components/schemas/NavCatalogItem"},"type":"array","title":"Items","description":"The hideable nav catalog (frontend-sourced)"},"signals":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Signals","description":"Optional account-derived hints, e.g. {'has_inventory': 'true'}"}},"type":"object","required":["description"],"title":"NavSuggestRequest","description":"Describe the business and the items the model may choose to hide."},"NavSuggestResponse":{"properties":{"hide":{"items":{"$ref":"#/components/schemas/NavSuggestHidden"},"type":"array","title":"Hide"},"profile_summary":{"type":"string","title":"Profile Summary","default":""}},"type":"object","title":"NavSuggestResponse","description":"AI proposal — the client renders this as a reviewable, editable diff."},"SuccessEnvelope_NavSuggestResponse_":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"data":{"anyOf":[{"$ref":"#/components/schemas/NavSuggestResponse"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"SuccessEnvelope[NavSuggestResponse]"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}