{"endpoint":"https://ewc.dev/api/agent/inquiries/","method":"POST","contentType":"application/json","purpose":"Send a project brief to EWC Designs on behalf of a client. The client confirms their email with a six-digit code; a person on the team then replies to that address.","agent":{"required":true,"name":"2 to 60 characters: letters, digits, space, dot, underscore, plus or hyphen","version":"optional, up to 40 characters"},"fields":{"name":{"required":true,"min":2,"max":100,"note":"The client's name, not the agent's."},"email":{"required":true,"max":254,"note":"One address the client can read now; the confirmation code and the reply go there."},"projectType":{"required":true,"max":120,"note":"What the client needs, in a few words."},"message":{"required":true,"min":20,"max":5000,"note":"The brief in the client's words, at most 3 links. No passwords, keys or private data."},"company":{"required":false,"max":160},"budget":{"required":false,"max":80},"locale":{"required":false,"values":["en","el","ro","pt"],"note":"Language for the code email and the reply."}},"headers":{"Idempotency-Key":"optional UUID v4; the same key with the same brief returns the same receipt instead of a duplicate"},"turnstile":{"required":true,"field":"turnstileToken","action":"inquiry_submit","maxLength":2048,"note":"Obtain a fresh token in the client's browser on the contact page. Bind cData to the lowercase Idempotency-Key when using that header. A retry needs a new token but retains the same key and brief. There is no unprotected scripted submission route."},"verification":{"required":true,"steps":["POST the brief. The answer is 202 with pending: true, the requestId and where the code went.","The client receives a six-digit code by email, valid for 30 minutes.","POST { \"requestId\", \"code\" } to https://ewc.dev/api/agent/inquiries/verify/, or let the client enter the code on the page named in the receipt. 200 means confirmed."],"verifyEndpoint":"https://ewc.dev/api/agent/inquiries/verify/","attempts":5,"validForSeconds":1800,"note":"Nothing reaches the team before the code is confirmed. The code is never returned by the API."},"limits":{"perSource":"3 briefs per 10 minutes","agentsPerDay":60,"sharedPerDay":240,"unconfirmedPerEmail":3,"bodyBytes":32768,"links":3},"responses":{"200":"replayed, same receipt","202":"stored, waiting for the client's code; receipt in body","400":"invalid brief, missing agent or a body that is not JSON (invalid_json), body says what to fix","403":"a form or plain-text body (application/x-www-form-urlencoded, multipart/form-data or text/plain) is refused by the site's origin check before this endpoint reads it; send Content-Type: application/json","409":"retry key used for a different brief","413":"body over 32 KB","415":"another content type that is not JSON","429":"over a limit, Retry-After set","503":"service unavailable","verify":{"200":"confirmed","400":"code_invalid: the code does not match, including for an unknown requestId; invalid_request: a malformed requestId or code","403":"a form or plain-text body, as above","410":"code_expired: open the page in the body with the client for a new code","413":"body over 4 KB","415":"another content type that is not JSON","429":"attempts_exhausted: open the page in the body with the client for a new code; rate_limited: too many requests, Retry-After set","503":"service unavailable"}},"example":{"agent":{"name":"ChatGPT","version":"5"},"name":"Jane Doe","email":"jane@company.com","projectType":"A new website","budget":"5,000 to 15,000","message":"We need a booking site for a dental clinic in Cluj, launch before March.","locale":"en"}}