> ## Documentation Index > Fetch the complete documentation index at: https://docs.evermind.ai/llms.txt > Use this file to discover all available pages before exploring further. # Submit feedback about one memory [Cloud-only] > Rate one memory — an episode, a profile item, an agent case or an agent skill — as `positive` or `negative`, optionally saying why. - Address the target the way /api/v2/memory/get or /search returned it: `memory_type` + `memory_id`, plus `item_id` for a profile (required there, rejected for the other kinds). - `reason` and `suggestion` go with negative ratings only; `note` is free text on either. - A target that does not exist, is deleted, or belongs to another tenant is rejected with 404. Recording is not applying: nothing about the memory is updated, deleted, suppressed or re-indexed. The response is the id of the stored signal. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v2/memory/feedback openapi: 3.1.0 info: title: EverOS Cloud Memory API version: 2.0.0 license: name: Apache-2.0 identifier: Apache-2.0 contact: name: EverMind AI email: service@evermind.ai url: https://github.com/EverMind-AI/everos-cloud-sdk-python description: >- Official Python client for the EverOS Cloud Memory API. Add, search, retrieve, and manage long-term memory for your AI applications over a typed interface (pydantic v2, with full type hints). Install and usage guides: https://github.com/EverMind-AI/everos-cloud-sdk-python servers: - url: https://api.evermind.ai description: Production security: - BearerAuth: [] paths: /api/v2/memory/feedback: post: tags: - Memory summary: Submit feedback about one memory [Cloud-only] description: >- Rate one memory — an episode, a profile item, an agent case or an agent skill — as `positive` or `negative`, optionally saying why. - Address the target the way /api/v2/memory/get or /search returned it: `memory_type` + `memory_id`, plus `item_id` for a profile (required there, rejected for the other kinds). - `reason` and `suggestion` go with negative ratings only; `note` is free text on either. - A target that does not exist, is deleted, or belongs to another tenant is rejected with 404. Recording is not applying: nothing about the memory is updated, deleted, suppressed or re-indexed. The response is the id of the stored signal. operationId: submitFeedback requestBody: content: application/json: schema: $ref: '#/components/schemas/FeedbackInput' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SuccessEnvelope_FeedbackData_' '401': description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/GatewayError' '403': description: >- Authenticated but not permitted — either rejected by the auth service, or the account's memory API version does not match the interface version implied by the path (a v1 account calling an /api/v2 route). content: application/json: schema: $ref: '#/components/schemas/GatewayError' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit or quota exceeded. content: application/json: schema: $ref: '#/components/schemas/GatewayError' '503': description: >- The gateway could not reach the authentication service. Transient — retry with backoff. content: application/json: schema: $ref: '#/components/schemas/GatewayError' components: schemas: FeedbackInput: properties: memory_type: type: string enum: - episode - profile - agent_case - agent_skill title: Memory Type description: Kind of the target memory, as named by memory.get / search. memory_id: type: string maxLength: 24 minLength: 24 pattern: ^[0-9a-fA-F]{24}$ title: Memory Id description: >- The target's `id` from memory.get / search (the profile document's id for `profile`). item_id: anyOf: - type: string pattern: ^(ei|it)_[0-9a-f]{24}$ - type: 'null' title: Item Id description: >- Which profile item is rated (`profile_data.*[].item_id`). Required for `profile`, not accepted for other kinds. rating: type: string enum: - positive - negative title: Rating description: Direction of the explicit assessment. reason: anyOf: - type: string enum: - hallucination - outdated - wrong_subject - wrong_time - redundant - privacy - style - other - type: 'null' title: Reason description: >- Structured reason used for analysis; it never triggers mutation. Negative ratings only. No default: an unset reason means the caller was not asked, `other` means they rejected the list — collapsing the two would corrupt every breakdown. Same base list as `Reason.code` on /api/v2/memory/update and /delete_by_ids minus `missing`, which a rating cannot express because it always names a memory that exists. (`outdated` — "right when written, wrong now" — reaches `Reason.code` with the engine's next release; on release-20260901_v15 it is feedback-only.) note: anyOf: - type: string maxLength: 256 minLength: 1 - type: 'null' title: Note description: Optional free-text explanation of the rating. suggestion: anyOf: - type: string maxLength: 8000 minLength: 1 - type: 'null' title: Suggestion description: >- What the memory should have said, as free text. Negative ratings only. Stored with the signal and never applied automatically. additionalProperties: false type: object required: - memory_type - memory_id - rating title: FeedbackInput description: >- Rate one memory record [Cloud-only]. The target is addressed the way the read APIs return it: ``memory_type`` + ``memory_id``, plus ``item_id`` for a profile, whose rateable unit is one item inside ``profile_data`` rather than the whole document. Everything identifying (tenant, submitter) is derived on the server; the whitelist is closed. A reason is DESCRIPTIVE. No code triggers a mutation by itself — ``privacy`` in particular is a signal, not a deletion request. example: memory_type: episode memory_id: 66dff0f8a9f84d8c9f62f011 rating: negative reason: outdated note: The user moved to Shanghai last month suggestion: The user currently lives in Shanghai. SuccessEnvelope_FeedbackData_: properties: request_id: type: string title: Request Id description: Request trace id (peer to data) data: $ref: '#/components/schemas/FeedbackData' description: Endpoint-defined business result type: object required: - request_id - data title: SuccessEnvelope[FeedbackData] GatewayError: type: object additionalProperties: true description: >- Gateway error body. NOTE: shape is not yet uniform across auth/quota/ rate-limit paths — treat fields as best-effort. Commonly includes a `code`/`message` (flat) or an `error` object/string with a `message`. title: GatewayError HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail description: One entry per field that failed validation. type: object title: HTTPValidationError FeedbackData: properties: id: type: string title: Id description: >- Id of the stored feedback signal. The rated memory itself is unchanged. type: object required: - id title: FeedbackData description: The stored signal's id. Nothing about the target memory changed. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location description: Path to the offending field, from the body root. msg: type: string title: Message description: What is wrong with it. type: type: string title: Error Type description: Machine-readable validation-error kind. type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: 'API key issued by EverOS, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.