{"openapi":"3.1.0","info":{"title":"Momcore Intel API","version":"1.1.0","description":"Active, confirmed @momcore.ai Admin bearer sessions only. Obtain access_token from the existing Momcore accounts API /v1/auth/login; refresh via /v1/auth/refresh. All data operations use caller RLS. Workforce source dates are reviewed dates; worker_as_of is only a published date."},"servers":[{"url":"https://intel-api.momcore.ai"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"FactoryInput":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"industry":{"type":"string"},"naics":{"type":"string"},"products":{"type":"string"},"status":{"type":"string"},"external_id":{"type":"string"},"worker_notes":{"type":"string"},"company_id":{"type":"string","format":"uuid"},"worker_count":{"type":["integer","null"],"minimum":0,"maximum":2147483647},"worker_count_kind":{"type":"string","enum":["reported","approximate","lower_bound"]},"worker_as_of":{"type":["string","null"],"format":"date"},"worker_as_of_precision":{"type":"string","enum":["day","month","year"]},"worker_source_url":{"type":"string","format":"uri"},"worker_source_date":{"type":["string","null"],"format":"date"},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180},"products_source":{"type":"string","enum":["reported","industry"]},"source_url":{"type":"string","format":"uri"},"source_date":{"type":["string","null"],"format":"date"}}},"CompanyInput":{"type":"object","properties":{"name":{"type":"string"},"website":{"type":"string"},"industry":{"type":"string"},"country":{"type":"string"},"procurement_cycle":{"type":"string"},"status":{"type":"string"},"source_url":{"type":"string"},"source_date":{"type":"string"}}},"PersonInput":{"type":"object","properties":{"company_id":{"type":"string"},"factory_id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"linkedin_url":{"type":"string"},"met_at":{"type":"string"},"last_contact_at":{"type":"string"},"next_follow_up":{"type":"string"},"status":{"type":"string"}}}}},"paths":{"/v1/overview":{"get":{"summary":"Full-index coverage totals","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}}},"/v1/map":{"get":{"summary":"Compact mapped factory array","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}}},"/v1/records/{kind}":{"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["factories","companies","people"]}}],"get":{"summary":"List and filter records; factories support inclusive min_workers","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"industry","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"company_id","in":"query","schema":{"type":"string"}},{"name":"min_workers","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}]},"post":{"summary":"Create a company, factory or person","responses":{"201":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FactoryInput"},{"$ref":"#/components/schemas/CompanyInput"},{"$ref":"#/components/schemas/PersonInput"}]}}}}}},"/v1/records/{kind}/{id}":{"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["factories","companies","people"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Read a record with linked context","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}},"patch":{"summary":"Update supplied fields; preserve all omitted fields","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FactoryInput"},{"$ref":"#/components/schemas/CompanyInput"},{"$ref":"#/components/schemas/PersonInput"}]}}}}}},"/v1/lookup/{kind}":{"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["factories","companies","people"]}}],"get":{"summary":"Look up records by name","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}}},"/v1/lead":{"post":{"summary":"Atomically create a conference lead and optional company or factory","responses":{"201":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"company_id":{"type":"string"},"factory_id":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"linkedin_url":{"type":"string"},"met_at":{"type":"string"},"last_contact_at":{"type":"string"},"next_follow_up":{"type":"string"},"status":{"type":"string"},"company_name":{"type":"string"},"factory_name":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"address":{"type":"string"},"products":{"type":"string"},"industry":{"type":"string"},"note":{"type":"string"},"worker_count":{"type":["integer","null"],"minimum":0},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]}}}}}}}},"/v1/comments/{kind}/{id}":{"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["factories","companies","people"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"summary":"Add shared context; body and category","responses":{"201":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["body"],"properties":{"body":{"type":"string","minLength":1,"maxLength":8000},"category":{"type":"string","enum":["note","procurement","meeting","follow_up"]}}}}}}}},"/v1/import":{"post":{"summary":"Create up to 100 CSV site rows; existing sites are skipped","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["rows"],"properties":{"rows":{"type":"array","maxItems":100,"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"industry":{"type":"string"},"naics":{"type":"string"},"products":{"type":"string"},"status":{"type":"string"},"external_id":{"type":"string"},"worker_notes":{"type":"string"},"company_id":{"type":"string","format":"uuid"},"worker_count":{"type":["integer","null"],"minimum":0,"maximum":2147483647},"worker_count_kind":{"type":"string","enum":["reported","approximate","lower_bound"]},"worker_as_of":{"type":["string","null"],"format":"date"},"worker_as_of_precision":{"type":"string","enum":["day","month","year"]},"worker_source_url":{"type":"string","format":"uri"},"worker_source_date":{"type":["string","null"],"format":"date"},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180},"products_source":{"type":"string","enum":["reported","industry"]},"source_url":{"type":"string","format":"uri"},"source_date":{"type":["string","null"],"format":"date"},"company_name":{"type":"string"}},"required":["name","company_name"]}}}}}}}}},"/v1/files/{kind}/{id}":{"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["factories","companies","people"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"summary":"Upload private attachment (multipart file, <=10 MB)","responses":{"201":{"description":"File manifest"}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}}}},"/v1/files/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Download an authorized attachment","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}}},"/v1/news/{company}":{"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Saved company and site headlines, with bounded live refresh","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}}},"post":{"summary":"Save a company news item with optional factory_id","responses":{"201":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","url"],"properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"published_at":{"type":["string","null"],"format":"date-time"},"factory_id":{"type":["string","null"],"format":"uuid"}}}}}}}},"/v1/news/{company}/{id}":{"parameters":[{"name":"company","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"patch":{"summary":"Attach or detach a company news story from a site","responses":{"200":{"description":"Success"},"400":{"description":"Invalid input"},"401":{"description":"Missing, expired or revoked session"},"403":{"description":"Momcore Admin required"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"factory_id":{"type":["string","null"],"format":"uuid"}}}}}}}}}}