AI Notes

This API is for the AI Notes resource of the Advisor API on the wealth.com platform. It allows connected systems to programmatically upload AI notes.


POSTadvisor-api.wealth.com/v1/ai-notes/{wid}

Upload AI Notes

This endpoint expects a wid for the top account to be passed as part of the URL.
upload_uri is url to which document content should be posted. The document's file extension is expected to be .json for this endpoint. See Using Upload URI for detailed upload instructions.

Upload AI Notes Request Object

  • Name
    name
    Type
    string (Max 200)
    Description

    The file name of the document to be uploaded. Required.

  • Name
    meetingTitle
    Type
    string (Max 500)
    Description

    Title of the meeting the AI notes are from. Optional.

  • Name
    meetingDateTime
    Type
    string (Max 64)
    Description

    Date and time of the meeting (e.g. ISO 8601 format). Optional.

  • Name
    source
    Type
    string (Max 200)
    Description

    Source of the AI notes (e.g. web-app, mobile). Optional.

  • Name
    participants
    Type
    array of strings
    Description

    List of meeting participants. Each string has a max length of 256. Optional.

Request

POST
advisor-api.wealth.com/v1/ai-notes/{wid}
  curl --location 'https://advisor-api.wealth.com/v1/ai-notes/786bb91c-35ec-49bb-bc28-1d2930d7db6a' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer xxxxxxxxxxxxx' \
    --data-raw '{
        "name": "meeting-2025-02-18",
        "meetingTitle": "Client XYZ Review",
        "meetingDateTime": "2025-02-18T14:30:00.000Z",
        "source": "web-app",
        "participants": ["Jane Smith", "John Davis"]
    }'

Upload AI Notes Response Object

  • Name
    wid
    Type
    string (Max 64)
    Description

    Wealth.com unique identifier for the client.

  • Name
    vault_id
    Type
    string (Max 64)
    Description

    Wealth.com unique identifier for the document.

  • Name
    upload_uri
    Type
    string (Max 2000)
    Description

    A secure link to upload the file. See Using Upload URI for detailed upload instructions.

Response

{
   "wid": "786bb91c-35ec-49bb-bc28-1d2930d7db6a",
   "vault_id": "53ac20e4-8287-4bd7-b7e7-8f09b056325f",
   "upload_uri": "https://vault.files.wealth.com/upload/..."
}

Error Responses

Status CodeError MessageDescription
400Bad RequestMissing required parameter (name) or invalid request body
403Access DeniedInvalid authorization token or insufficient permissions
404Container not foundThe specified client (wid) does not exist
500Internal Server ErrorUnexpected server error