> For the complete documentation index, see [llms.txt](https://movemint.gitbook.io/movemint-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://movemint.gitbook.io/movemint-developer-docs/open-api-specification/core-resources/suggestions.md).

# Suggestions

Organizer feature requests captured by the in-app Movemint AI assistant. `submit_suggestion` forwards a request to the Movemint product team when the assistant hits something it can't do.

## Submit an organizer suggestion to the product team

> Forwards a feature request the organizer made through Movemint AI to the\
> Movemint product team. The assistant calls this when it hits something it\
> can't do and the organizer confirms they want it passed along. The\
> submitting organizer — and the event they were working on, when the\
> conversation is focused on one — are attached automatically from the\
> session, so the body carries only the suggestion text. Nothing is\
> persisted beyond the assistant's own action-audit trail. Restricted to\
> the in-app assistant: a token without the \`ai\_chat\` scope gets 403.<br>

````json
{"openapi":"3.1.0","info":{"title":"Movemint API","version":"1.0"},"tags":[{"name":"Suggestions","description":"Organizer feature requests captured by the in-app Movemint AI assistant.\n`submit_suggestion` forwards a request to the Movemint product team when\nthe assistant hits something it can't do.\n"}],"servers":[{"url":"https://www.movemint.cc","description":"Production"}],"security":[{"bearerAuth":[]},{"oauth2":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Pass the access token in the `Authorization` header:\n```\nAuthorization: Bearer YOUR_ACCESS_TOKEN\n```\n"},"oauth2":{"type":"oauth2","description":"OAuth 2.0 authentication using the Authorization Code or Client\nCredentials grant flow.\n","flows":{"authorizationCode":{"authorizationUrl":"https://www.movemint.cc/oauth/authorize","tokenUrl":"https://www.movemint.cc/oauth/token","refreshUrl":"https://www.movemint.cc/oauth/token","scopes":{}},"clientCredentials":{"tokenUrl":"https://www.movemint.cc/oauth/token","scopes":{}}}}},"responses":{"Unauthorized":{"description":"Unauthorized - invalid or missing token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthError"}}}}},"schemas":{"OAuthError":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code"},"error_description":{"type":"string","description":"Human-readable description of the error"}}}}},"paths":{"/api/v1/ai_suggestions":{"post":{"tags":["Suggestions"],"summary":"Submit an organizer suggestion to the product team","description":"Forwards a feature request the organizer made through Movemint AI to the\nMovemint product team. The assistant calls this when it hits something it\ncan't do and the organizer confirms they want it passed along. The\nsubmitting organizer — and the event they were working on, when the\nconversation is focused on one — are attached automatically from the\nsession, so the body carries only the suggestion text. Nothing is\npersisted beyond the assistant's own action-audit trail. Restricted to\nthe in-app assistant: a token without the `ai_chat` scope gets 403.\n","operationId":"submitAiSuggestion","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["suggestion"],"properties":{"suggestion":{"type":"string","description":"The organizer's request as a self-contained sentence or two.\nTrimmed, and truncated to 2000 characters.\n"}}}}}},"responses":{"201":{"description":"Suggestion forwarded to the product team","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"The token is not the in-app Movemint AI assistant","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"string"}}}}}},"422":{"description":"The suggestion was blank","content":{"application/json":{"schema":{"type":"object","required":["errors"],"properties":{"errors":{"type":"string"}}}}}}}}}}}
````