Rolli
Rolli API Documentation

Integration Setup

View or update your integration settings (for example, return_url used for webhook notifications).

GET /api/setup

Request Example

curl -X GET "https://rolli.ai/api/setup" \
  -H "X-ROLLI-TOKEN: your_token" \
  -H "X-ROLLI-USER-ID: your_user_id" \
  -H "Content-Type: application/json"
    
fetch("https://rolli.ai/api/setup", {
  method: "GET",
  headers: {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
  },
})
  .then(res => res.json())
  .then(console.log);
    
require "net/http"
require "uri"
require "json"

uri = URI("https://rolli.ai/api/setup")
req = Net::HTTP::Get.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

puts res.body
    
import requests
import json

url = "https://rolli.ai/api/setup"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}response = requests.get(url, headers=headers)

print(response.json())

Response Example

{
  "return_url": "http://www.integratedapp.com/rolli-webhook",
  "name": "Integrated App"
}

PUT /api/setup

Parameters

return_url String
URL that will receive webhook notifications when a search completes.

Request Example

curl -X PUT "https://rolli.ai/api/setup" \
  -H "X-ROLLI-TOKEN: your_token" \
  -H "X-ROLLI-USER-ID: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
  "return_url": "https://yourapp.com/rolli-webhook"
}'
    
fetch("https://rolli.ai/api/setup", {
  method: "PUT",
  headers: {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"return_url":"https://yourapp.com/rolli-webhook"})
})
  .then(res => res.json())
  .then(console.log);
    
require "net/http"
require "uri"
require "json"

uri = URI("https://rolli.ai/api/setup")
req = Net::HTTP::Put.new(uri)
req["X-ROLLI-TOKEN"] = "your_token"
req["X-ROLLI-USER-ID"] = "your_user_id"
req["Content-Type"] = "application/json"
req.body = {"return_url":"https://yourapp.com/rolli-webhook"}.to_json

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(req)
end

puts res.body
    
import requests
import json

url = "https://rolli.ai/api/setup"
headers = {
    "X-ROLLI-TOKEN": "your_token",
    "X-ROLLI-USER-ID": "your_user_id",
    "Content-Type": "application/json"
}

payload = {
  "return_url": "https://yourapp.com/rolli-webhook"
}
response = requests.put(url, json=payload, headers=headers)

print(response.json())

Response Example

{
  "return_url": "https://yourapp.com/rolli-webhook",
  "name": "Your Application Name"
}

If return_url is set, Rolli will POST completed search results to that URL (same payload as GET /api/search/{id}).