Suggest Decision

curl --request POST \
  --url https://api.velt.dev/v2/memory/suggest \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '
{
  "data": {
    "query": "<string>",
    "organizationId": "<string>",
    "documentId": "<string>"
  }
}
'

import requests

url = "https://api.velt.dev/v2/memory/suggest"

payload = { "data": {
        "query": "<string>",
        "organizationId": "<string>",
        "documentId": "<string>"
    } }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({data: {query: '<string>', organizationId: '<string>', documentId: '<string>'}})
};

fetch('https://api.velt.dev/v2/memory/suggest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/memory/suggest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'query' => '<string>',
        'organizationId' => '<string>',
        'documentId' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/memory/suggest"

	payload := strings.NewReader("{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/memory/suggest")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/memory/suggest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "result": {
    "primary": {
      "recommendation": "reject",
      "confidence": 0.78,
      "basedOn": 12,
      "scope": "organization",
      "scopeLabel": "This organization",
      "topReasons": ["Unsupported medical claim", "Missing citation"],
      "uniqueReviewers": 4,
      "caveats": ["Stale pattern: >70% of supporting data is older than 6 months"]
    },
    "conflict": null
  }
}

POST

memory

suggest

Suggest Decision

curl --request POST \
  --url https://api.velt.dev/v2/memory/suggest \
  --header 'Content-Type: application/json' \
  --header 'x-velt-api-key: <x-velt-api-key>' \
  --header 'x-velt-auth-token: <x-velt-auth-token>' \
  --data '
{
  "data": {
    "query": "<string>",
    "organizationId": "<string>",
    "documentId": "<string>"
  }
}
'

import requests

url = "https://api.velt.dev/v2/memory/suggest"

payload = { "data": {
        "query": "<string>",
        "organizationId": "<string>",
        "documentId": "<string>"
    } }
headers = {
    "x-velt-api-key": "<x-velt-api-key>",
    "x-velt-auth-token": "<x-velt-auth-token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-velt-api-key': '<x-velt-api-key>',
    'x-velt-auth-token': '<x-velt-auth-token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({data: {query: '<string>', organizationId: '<string>', documentId: '<string>'}})
};

fetch('https://api.velt.dev/v2/memory/suggest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velt.dev/v2/memory/suggest",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        'query' => '<string>',
        'organizationId' => '<string>',
        'documentId' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-velt-api-key: <x-velt-api-key>",
    "x-velt-auth-token: <x-velt-auth-token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.velt.dev/v2/memory/suggest"

	payload := strings.NewReader("{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-velt-api-key", "<x-velt-api-key>")
	req.Header.Add("x-velt-auth-token", "<x-velt-auth-token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.velt.dev/v2/memory/suggest")
  .header("x-velt-api-key", "<x-velt-api-key>")
  .header("x-velt-auth-token", "<x-velt-auth-token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.velt.dev/v2/memory/suggest")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-velt-api-key"] = '<x-velt-api-key>'
request["x-velt-auth-token"] = '<x-velt-auth-token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": {\n    \"query\": \"<string>\",\n    \"organizationId\": \"<string>\",\n    \"documentId\": \"<string>\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "result": {
    "primary": {
      "recommendation": "reject",
      "confidence": 0.78,
      "basedOn": 12,
      "scope": "organization",
      "scopeLabel": "This organization",
      "topReasons": ["Unsupported medical claim", "Missing citation"],
      "uniqueReviewers": 4,
      "caveats": ["Stale pattern: >70% of supporting data is older than 6 months"]
    },
    "conflict": null
  }
}

Use this API to compute a suggested decision for a new item, grounded in past judgments. primary is the best-grounded recommendation; conflict is populated when the evidence is split, so you can surface disagreement to your users.

Endpoint

POST https://api.velt.dev/v2/memory/suggest

Headers

string

required

Your API key.

string

required

Your Auth Token.

Body

Params

object

required

Show properties

string

required

Non-empty. Describe the item being decided.

string

Narrow the precedent to one organization.

string

Narrow the precedent to one document. Only applied when organizationId is also set. Sent alone, it is ignored and the search stays workspace-wide.

Example Requests

Suggest a decision for new ad copy

{
  "data": {
    "query": "Ad copy: \"clinically proven to reduce wrinkles\""
  }
}

Response

Both primary and conflict are a suggestion object or null. recommendation is approve or reject. basedOn is the number of judgments the suggestion drew on, and uniqueReviewers is how many distinct people decided them. scope is document, organization, or apiKey. scopeLabel is the matching display string, one of This document, This organization, or All content; it never carries your own organization or document name. Only judgments whose decision is approved, agree, endorse, or document_approved count toward an approve recommendation. Only rejected, disagree, or document_rejected count toward reject. Judgments with any other decision value, such as comment or resolve, count toward neither side. primary is null when no past judgments matched, or when fewer than 2 records support the leading decision. conflict is non-null only when approve and reject each have 2 or more supporting records. On primary, caveats carries four kinds of warning: a conflict between the two sides, a knowledge source updated in the last 48 hours, a stale pattern where over 70% of the supporting data is older than 6 months, and partial data when a scope times out. On conflict, caveats always carries one minority-view note comparing the two record counts.

Success Response

{
  "result": {
    "primary": {
      "recommendation": "reject",
      "confidence": 0.78,
      "basedOn": 12,
      "scope": "organization",
      "scopeLabel": "This organization",
      "topReasons": ["Unsupported medical claim", "Missing citation"],
      "uniqueReviewers": 4,
      "caveats": ["Stale pattern: >70% of supporting data is older than 6 months"]
    },
    "conflict": null
  }
}

Failure Response

{
  "error": {
    "message": "ERROR_MESSAGE",
    "status": "INVALID_ARGUMENT"
  }
}

{
  "result": {
    "primary": {
      "recommendation": "reject",
      "confidence": 0.78,
      "basedOn": 12,
      "scope": "organization",
      "scopeLabel": "This organization",
      "topReasons": ["Unsupported medical claim", "Missing citation"],
      "uniqueReviewers": 4,
      "caveats": ["Stale pattern: >70% of supporting data is older than 6 months"]
    },
    "conflict": null
  }
}

⌘I

REST APIs

SDK

Suggest Decision

Endpoint

Headers

Body

Params

Example Requests

Suggest a decision for new ad copy

Response

Success Response

Failure Response

​Endpoint

​Headers

​Body

​Params

​Example Requests

​Suggest a decision for new ad copy

​Response

​Success Response

​Failure Response

Endpoint

Headers

Body

Params

Example Requests

Suggest a decision for new ad copy

Response

Success Response

Failure Response