| why | No | Why you need it: the problem, and what you were trying to do when you hit it. Required for missing and idea. | |
| area | No | The part of DevReply it's about, e.g. ios or mcp. | |
| kind | Yes | bug, missing (a feature or API you needed), confusing, docs, idea, or praise. | |
| title | Yes | One line, up to 160 characters. | |
| app_id | No | The app's id (from list_apps). Optional when there is only one. | |
| impact | No | Does it block the app, degrade it, or is it nice to have? | |
| details | No | What you tried, what happened, what you expected or would like. Code, API names and versions help. | |
| outcome | No | What would improve, and for whom (the app's users, its team, you). | |
| proposal | No | The API or solution you'd suggest, with an example call if you have one. | |
| use_case | No | The concrete situation in the app (e.g. 'billing chats from the paywall arrive without the store error'). Required for missing and idea. | |
| workaround | No | What you do today instead, if anything, and what it costs. | |
| app_context | No | The kind of app, its stack and scale, anything that makes the request make sense. No secrets, no user data. | |
| sdk_version | No | The DevReply SDK version the app uses, if it's about an SDK, e.g. "0.5.0". | |