Search bindings by tag or asset
curl --request POST \
--url http://localhost:3000/api/v1/tags/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent": "<string>",
"artifact": "<string>",
"callProfile": "<string>",
"callRequest": "<string>",
"callTool": "<string>",
"callVoiceAgent": "<string>",
"chat": "<string>",
"command": "<string>",
"contact": "<string>",
"cronJob": "<string>",
"cursor": "<string>",
"devinSession": "<string>",
"fields": "<string>",
"hook": "<string>",
"insight": "<string>",
"instance": "<string>",
"kind": "<string>",
"limit": "<string>",
"order": "<string>",
"profile": "<string>",
"project": "<string>",
"route": "<string>",
"session": "<string>",
"skill": "<string>",
"skillGateRule": "<string>",
"sort": "<string>",
"source": "<string>",
"tag": "<string>",
"target": "<string>",
"task": "<string>",
"taskAutomation": "<string>",
"trigger": "<string>",
"workflowNode": "<string>",
"workflowRun": "<string>",
"workflowSpec": "<string>"
}
'import requests
url = "http://localhost:3000/api/v1/tags/search"
payload = {
"agent": "<string>",
"artifact": "<string>",
"callProfile": "<string>",
"callRequest": "<string>",
"callTool": "<string>",
"callVoiceAgent": "<string>",
"chat": "<string>",
"command": "<string>",
"contact": "<string>",
"cronJob": "<string>",
"cursor": "<string>",
"devinSession": "<string>",
"fields": "<string>",
"hook": "<string>",
"insight": "<string>",
"instance": "<string>",
"kind": "<string>",
"limit": "<string>",
"order": "<string>",
"profile": "<string>",
"project": "<string>",
"route": "<string>",
"session": "<string>",
"skill": "<string>",
"skillGateRule": "<string>",
"sort": "<string>",
"source": "<string>",
"tag": "<string>",
"target": "<string>",
"task": "<string>",
"taskAutomation": "<string>",
"trigger": "<string>",
"workflowNode": "<string>",
"workflowRun": "<string>",
"workflowSpec": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent: '<string>',
artifact: '<string>',
callProfile: '<string>',
callRequest: '<string>',
callTool: '<string>',
callVoiceAgent: '<string>',
chat: '<string>',
command: '<string>',
contact: '<string>',
cronJob: '<string>',
cursor: '<string>',
devinSession: '<string>',
fields: '<string>',
hook: '<string>',
insight: '<string>',
instance: '<string>',
kind: '<string>',
limit: '<string>',
order: '<string>',
profile: '<string>',
project: '<string>',
route: '<string>',
session: '<string>',
skill: '<string>',
skillGateRule: '<string>',
sort: '<string>',
source: '<string>',
tag: '<string>',
target: '<string>',
task: '<string>',
taskAutomation: '<string>',
trigger: '<string>',
workflowNode: '<string>',
workflowRun: '<string>',
workflowSpec: '<string>'
})
};
fetch('http://localhost:3000/api/v1/tags/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/api/v1/tags/search",
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([
'agent' => '<string>',
'artifact' => '<string>',
'callProfile' => '<string>',
'callRequest' => '<string>',
'callTool' => '<string>',
'callVoiceAgent' => '<string>',
'chat' => '<string>',
'command' => '<string>',
'contact' => '<string>',
'cronJob' => '<string>',
'cursor' => '<string>',
'devinSession' => '<string>',
'fields' => '<string>',
'hook' => '<string>',
'insight' => '<string>',
'instance' => '<string>',
'kind' => '<string>',
'limit' => '<string>',
'order' => '<string>',
'profile' => '<string>',
'project' => '<string>',
'route' => '<string>',
'session' => '<string>',
'skill' => '<string>',
'skillGateRule' => '<string>',
'sort' => '<string>',
'source' => '<string>',
'tag' => '<string>',
'target' => '<string>',
'task' => '<string>',
'taskAutomation' => '<string>',
'trigger' => '<string>',
'workflowNode' => '<string>',
'workflowRun' => '<string>',
'workflowSpec' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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 := "http://localhost:3000/api/v1/tags/search"
payload := strings.NewReader("{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <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("http://localhost:3000/api/v1/tags/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/api/v1/tags/search")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"behaviorConsumers": [
{}
],
"bindings": [
{}
],
"filters": {},
"items": [
{}
],
"page": {
"count": 123,
"hasMore": true,
"limit": 123,
"nextCommand": "<string>",
"nextCursor": "<string>",
"order": "<string>",
"sort": "<string>"
},
"total": 123
}tags
Search bindings by tag or asset
POST
/
api
/
v1
/
tags
/
search
Search bindings by tag or asset
curl --request POST \
--url http://localhost:3000/api/v1/tags/search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent": "<string>",
"artifact": "<string>",
"callProfile": "<string>",
"callRequest": "<string>",
"callTool": "<string>",
"callVoiceAgent": "<string>",
"chat": "<string>",
"command": "<string>",
"contact": "<string>",
"cronJob": "<string>",
"cursor": "<string>",
"devinSession": "<string>",
"fields": "<string>",
"hook": "<string>",
"insight": "<string>",
"instance": "<string>",
"kind": "<string>",
"limit": "<string>",
"order": "<string>",
"profile": "<string>",
"project": "<string>",
"route": "<string>",
"session": "<string>",
"skill": "<string>",
"skillGateRule": "<string>",
"sort": "<string>",
"source": "<string>",
"tag": "<string>",
"target": "<string>",
"task": "<string>",
"taskAutomation": "<string>",
"trigger": "<string>",
"workflowNode": "<string>",
"workflowRun": "<string>",
"workflowSpec": "<string>"
}
'import requests
url = "http://localhost:3000/api/v1/tags/search"
payload = {
"agent": "<string>",
"artifact": "<string>",
"callProfile": "<string>",
"callRequest": "<string>",
"callTool": "<string>",
"callVoiceAgent": "<string>",
"chat": "<string>",
"command": "<string>",
"contact": "<string>",
"cronJob": "<string>",
"cursor": "<string>",
"devinSession": "<string>",
"fields": "<string>",
"hook": "<string>",
"insight": "<string>",
"instance": "<string>",
"kind": "<string>",
"limit": "<string>",
"order": "<string>",
"profile": "<string>",
"project": "<string>",
"route": "<string>",
"session": "<string>",
"skill": "<string>",
"skillGateRule": "<string>",
"sort": "<string>",
"source": "<string>",
"tag": "<string>",
"target": "<string>",
"task": "<string>",
"taskAutomation": "<string>",
"trigger": "<string>",
"workflowNode": "<string>",
"workflowRun": "<string>",
"workflowSpec": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent: '<string>',
artifact: '<string>',
callProfile: '<string>',
callRequest: '<string>',
callTool: '<string>',
callVoiceAgent: '<string>',
chat: '<string>',
command: '<string>',
contact: '<string>',
cronJob: '<string>',
cursor: '<string>',
devinSession: '<string>',
fields: '<string>',
hook: '<string>',
insight: '<string>',
instance: '<string>',
kind: '<string>',
limit: '<string>',
order: '<string>',
profile: '<string>',
project: '<string>',
route: '<string>',
session: '<string>',
skill: '<string>',
skillGateRule: '<string>',
sort: '<string>',
source: '<string>',
tag: '<string>',
target: '<string>',
task: '<string>',
taskAutomation: '<string>',
trigger: '<string>',
workflowNode: '<string>',
workflowRun: '<string>',
workflowSpec: '<string>'
})
};
fetch('http://localhost:3000/api/v1/tags/search', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/api/v1/tags/search",
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([
'agent' => '<string>',
'artifact' => '<string>',
'callProfile' => '<string>',
'callRequest' => '<string>',
'callTool' => '<string>',
'callVoiceAgent' => '<string>',
'chat' => '<string>',
'command' => '<string>',
'contact' => '<string>',
'cronJob' => '<string>',
'cursor' => '<string>',
'devinSession' => '<string>',
'fields' => '<string>',
'hook' => '<string>',
'insight' => '<string>',
'instance' => '<string>',
'kind' => '<string>',
'limit' => '<string>',
'order' => '<string>',
'profile' => '<string>',
'project' => '<string>',
'route' => '<string>',
'session' => '<string>',
'skill' => '<string>',
'skillGateRule' => '<string>',
'sort' => '<string>',
'source' => '<string>',
'tag' => '<string>',
'target' => '<string>',
'task' => '<string>',
'taskAutomation' => '<string>',
'trigger' => '<string>',
'workflowNode' => '<string>',
'workflowRun' => '<string>',
'workflowSpec' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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 := "http://localhost:3000/api/v1/tags/search"
payload := strings.NewReader("{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <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("http://localhost:3000/api/v1/tags/search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/api/v1/tags/search")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"agent\": \"<string>\",\n \"artifact\": \"<string>\",\n \"callProfile\": \"<string>\",\n \"callRequest\": \"<string>\",\n \"callTool\": \"<string>\",\n \"callVoiceAgent\": \"<string>\",\n \"chat\": \"<string>\",\n \"command\": \"<string>\",\n \"contact\": \"<string>\",\n \"cronJob\": \"<string>\",\n \"cursor\": \"<string>\",\n \"devinSession\": \"<string>\",\n \"fields\": \"<string>\",\n \"hook\": \"<string>\",\n \"insight\": \"<string>\",\n \"instance\": \"<string>\",\n \"kind\": \"<string>\",\n \"limit\": \"<string>\",\n \"order\": \"<string>\",\n \"profile\": \"<string>\",\n \"project\": \"<string>\",\n \"route\": \"<string>\",\n \"session\": \"<string>\",\n \"skill\": \"<string>\",\n \"skillGateRule\": \"<string>\",\n \"sort\": \"<string>\",\n \"source\": \"<string>\",\n \"tag\": \"<string>\",\n \"target\": \"<string>\",\n \"task\": \"<string>\",\n \"taskAutomation\": \"<string>\",\n \"trigger\": \"<string>\",\n \"workflowNode\": \"<string>\",\n \"workflowRun\": \"<string>\",\n \"workflowSpec\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"behaviorConsumers": [
{}
],
"bindings": [
{}
],
"filters": {},
"items": [
{}
],
"page": {
"count": 123,
"hasMore": true,
"limit": 123,
"nextCommand": "<string>",
"nextCursor": "<string>",
"order": "<string>",
"sort": "<string>"
},
"total": 123
}Authorizations
Runtime context-key (rctx_*) issued by the Ravi gateway. Used by ordinary gateway operations; not accepted by Console-only operations. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.
Body
application/json
Filter by agent id
Filter by artifact id
Filter by prox call profile id
Filter by prox call request id
Filter by prox call tool id
Filter by prox call voice agent id
Filter by canonical chat id
Filter by Ravi command id
Filter by contact id
Filter by cron job id
Opaque cursor returned by the previous page
Filter by Devin session id
Compact mode: keep only these fields of each item
Filter by hook id
Filter by insight id
Filter by Ravi channel instance name
Filter by tag kind: system|user
Page size (default: 30, max: 500)
Sort direction: asc|desc
Filter by task profile id
Filter by project id
Filter by route id
Filter by session name
Filter by skill name
Filter by skill gate rule id
Sort field: updated|created
Filter by binding provenance source
Filter by tag slug
Generic target selector, e.g. task:task-123 or workflow_run:wfr-123
Filter by task id
Filter by task automation id
Filter by trigger id
Filter by workflow node id
Filter by workflow run id
Filter by workflow spec id
Response
Success — body conforms to the @Returns schema.