{"openapi":"3.1.0","info":{"title":"Ibrahim Hussien — Public Portfolio API","version":"1.0.0","description":"Read-only API exposing published portfolio content. No authentication. Drafts, private settings and messages are never returned. /api/public/* supports only GET and OPTIONS; /api/chat accepts POST questions."},"servers":[{"url":"https://ibrahim-portfolio-five-delta.vercel.app/"}],"paths":{"/api/public/profile":{"get":{"summary":"Profile, identities, public contact links and resource URLs","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"name":{"type":"string"},"fullName":{"type":"string"},"headline":{"type":"string"},"summary":{"type":"string"},"location":{"type":"string"},"identities":{"type":"array","items":{"type":"object"}},"socials":{"type":"array","items":{"type":"object"}},"cv":{"type":"object","nullable":true}}}}}}}}},"/api/public/projects":{"get":{"summary":"Published projects","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/projects/{slug}":{"get":{"summary":"A published project by slug","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}},"404":{"description":"Not found"}}}},"/api/public/experience":{"get":{"summary":"Professional experience (tracks: engineering, teaching, freelance, business, training)","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/education":{"get":{"summary":"Education","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/skills":{"get":{"summary":"Skill groups","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/services":{"get":{"summary":"Freelance services","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/certifications":{"get":{"summary":"Certifications and awards","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/articles":{"get":{"summary":"Published articles","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/articles/{slug}":{"get":{"summary":"A published article by slug (Markdown body)","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}},"404":{"description":"Not found"}}}},"/api/public/videos":{"get":{"summary":"Published videos","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/repos":{"get":{"summary":"Curated public GitHub repositories","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/pages":{"get":{"summary":"Published pages","tags":["public"],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}}}}}}}},"/api/public/pages/{slug}":{"get":{"summary":"A published page with its visible content blocks","tags":["public"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"id":{"type":"string"},"updatedAt":{"type":"string","format":"date-time","nullable":true}}}}}},"404":{"description":"Not found"}}}},"/api/chat":{"post":{"summary":"Ask the local assistant a question about Ibrahim (answers only from published content; rate limited)","tags":["chat"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Answer","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"type":"string"},"answered":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"}}}}}}}}},"429":{"description":"Rate limited"}}}}}}