{"openapi":"3.1.0","info":{"title":"Brainforge public contact form API","version":"1.0.0","description":"Submits a contact or consultation request to Brainforge. This is a write-only lead capture endpoint; it does not expose customer data. The current contract is version 1.0.0. Brainforge will publish a new version before breaking changes and will use Deprecation and Sunset headers during retirement.","contact":{"email":"help@brainforge.ai"}},"servers":[{"url":"https://brainforge.ai","description":"Production. The API contract is version 1.0.0."}],"paths":{"/api/forms/submit":{"post":{"operationId":"submitContactForm","summary":"Submit a contact or consultation request","description":"Submit a valid email and one or more form fields. Do not send sensitive personal data.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormSubmission"}}}},"responses":{"200":{"description":"Submission accepted","headers":{"RateLimit":{"schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Success"}}}},"400":{"description":"Invalid submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"}},"RateLimit":{"schema":{"type":"string"}},"RateLimit-Policy":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Submission provider unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Submission service not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"FormSubmission":{"type":"object","required":["startedAt","fields"],"properties":{"startedAt":{"type":"number","description":"Client timestamp in milliseconds."},"formName":{"type":"string"},"formType":{"type":"string"},"fields":{"type":"array","minItems":1,"items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}},"additionalProperties":false}},"honeypot":{"type":"string"},"pageUri":{"type":"string","format":"uri"},"pageName":{"type":"string"}},"additionalProperties":false},"Success":{"type":"object","required":["success","message"],"properties":{"success":{"const":true},"message":{"type":"string"}},"additionalProperties":true},"Error":{"type":"object","required":["success","message"],"properties":{"success":{"const":false},"message":{"type":"string"},"retryAfterSeconds":{"type":"integer"}},"additionalProperties":true}}}}