List available group versions a binding can be upgraded to

curl --request GET \
  --url https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions', 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.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <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"
	"net/http"
	"io"
)

func main() {

	url := "https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "version": "<string>",
    "name": "<string>",
    "description": "<string>",
    "regoSource": "<string>",
    "regoSourceHash": "<string>",
    "bindingCount": 123,
    "validFrom": "2023-11-07T05:31:56Z",
    "validTo": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Auth Types	Entities	Permissions	Required Roles
USER	TENANT	READ	TENANT:READ

GET

relay

policy-bindings

{bindingId}

available-versions

List available group versions a binding can be upgraded to

curl --request GET \
  --url https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions', 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.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <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"
	"net/http"
	"io"
)

func main() {

	url := "https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.swarmd.ai/relay/v1/policy-bindings/{bindingId}/available-versions")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

[
  {
    "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "version": "<string>",
    "name": "<string>",
    "description": "<string>",
    "regoSource": "<string>",
    "regoSourceHash": "<string>",
    "bindingCount": 123,
    "validFrom": "2023-11-07T05:31:56Z",
    "validTo": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization

string

header

required

JWT token (USER, AGENT, or SERVICE auth)

Path Parameters

bindingId

string<uuid>

required

Response

200 - application/json

groupId

string<uuid>

version

string

name

string

description

string

regoSource

string

regoSourceHash

string

bindingCount

integer<int64>

validFrom

string<date-time>

validTo

string<date-time>

createdAt

string<date-time>

List active policy bindings with optional filters Get version history for a policy binding

Overview

Policy Groups

Policy Bindings

Webhooks

Human JSON-RPC

Channel JSON-RPC

HITL Approvals

Agent JSON-RPC

Tasks

Push Notifications

Messaging

Conversations

Agent Discovery

User Subscriptions

MCP Servers

Kill Switches

Channels

Channel Subscriptions

Agents

Agent Subscriptions

Marketplace

Identity Providers

Groups

Authentication

Users

Tenants

Audit Integrity

Audit Events

Audit Traces

A2A Payments

List available group versions a binding can be upgraded to

Authorizations

Path Parameters

Response