{"Protocol":"AIXE","Version":"1.0","ProtocolReference":{"Inventor":"Gregory Oglethorpe","Home":"http://aixeprotocol.com/","Usage":"http://aixeprotocol.com/usage/?","Specification":"http://aixeprotocol.com/whitepaper/full-spec.html"},"Endpoint":"/aixe/conversations/save-private-note","Method":"POST","ContentType":"application/json","Title":"Save Private Note","Description":"Save Private Note. Use the documented inputs and the current access rules for the selected account and profile.","RequiresAuthenticationToken":true,"Authentication":"PersonAuthenticationToken in JSON body (text form part for upload); 15-minute sliding idle expiry. Re-login after expiry.","InputFields":[{"Name":"PersonAuthenticationToken","Type":"string","Required":true,"Description":"Secret token returned by login. Never put it in a URL or expose it to another member."},{"Name":"ActingMatchingProfileKey","Type":"GUID string","Required":true,"Description":"Owned profile acting in this request. Social actions require Active state; read and management exceptions are described by the operation."},{"Name":"ConversationKey","Type":"GUID string","Required":true,"Description":"Opaque resource key returned by the relevant read/list action."},{"Name":"Version","Type":"string","Required":true,"Description":"Exact Version returned by the latest read. Reload after a conflict."},{"Name":"Content","Type":"string","Required":true,"Description":"Plain text, up to 4000 characters. Profile content is optional; Thoughts are owner-private; conversation notes are participant-private."}],"BusinessInputs":"PersonAuthenticationToken (required); ActingMatchingProfileKey (required); ConversationKey (required); Version (required); Content (required)","PrivateAccess":"No endpoint-specific grant.","Guidance":"Use only resources accessible to the selected profile. No address collection. Private Thoughts and operational email settings never belong to another member\u2019s response.","Pagination":{"Default":20,"Maximum":50,"Cursor":"Opaque server-issued NextCursor; apply to the same acting profile and filters.","Order":"Stable operation-specific order"},"Response":{"SuccessCode":"SUCCESS","Message":"Action completed.","Data":"Declared operation result; resource keys only. No PersonKey or numeric IDs.","PersonAuthenticationTokenExpiration":"UTC ISO-8601 when authenticated"},"Errors":["VALIDATION_FAILED","AUTHENTICATION_REQUIRED","LOGIN_FAILED","EMAIL_ALREADY_REGISTERED","NOT_FOUND","REJECTED","BUSINESS_RULE_FAILED","CONFLICT","RATE_LIMITED","FAILED"],"Recovery":"Correct validation inputs; reload on conflict; log in again on expired authentication. Never retry absent authorization.","Retry":"Read current state after an uncertain mutation result before retrying.","Example":{"Request":{"PersonAuthenticationToken":"TOKEN_FROM_LOGIN","ActingMatchingProfileKey":"00000000-0000-0000-0000-000000000001","ConversationKey":"00000000-0000-0000-0000-000000000001","Version":"VERSION_FROM_LATEST_READ","Content":"Example content"},"Failure":{"SuccessCode":"VALIDATION_FAILED","Message":"Select a valid required resource."}}}