List all versions of a group (audit history)

curl --request GET \
  --url https://api.swarmd.ai/tenant-auth/v1/groups/{groupId}/versions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.swarmd.ai/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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

{
  "totalElements": 123,
  "totalPages": 123,
  "first": true,
  "last": true,
  "size": 123,
  "content": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "permissions": [
        {}
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "isDefault": true,
      "isAdmin": true,
      "version": "<string>",
      "archivedAt": "2023-11-07T05:31:56Z",
      "createdBy": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "permissions": [
          {}
        ],
        "firstName": "<string>",
        "lastName": "<string>",
        "source": "<string>",
        "groupIds": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ]
      },
      "reason": "<string>"
    }
  ],
  "number": 123,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "pageable": {
    "offset": 123,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "pageNumber": 123,
    "pageSize": 123,
    "paged": true,
    "unpaged": true
  },
  "numberOfElements": 123,
  "empty": true
}

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

GET

tenant-auth

groups

{groupId}

versions

List all versions of a group (audit history)

curl --request GET \
  --url https://api.swarmd.ai/tenant-auth/v1/groups/{groupId}/versions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.swarmd.ai/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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/tenant-auth/v1/groups/{groupId}/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

{
  "totalElements": 123,
  "totalPages": 123,
  "first": true,
  "last": true,
  "size": 123,
  "content": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "permissions": [
        {}
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "isDefault": true,
      "isAdmin": true,
      "version": "<string>",
      "archivedAt": "2023-11-07T05:31:56Z",
      "createdBy": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "email": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "permissions": [
          {}
        ],
        "firstName": "<string>",
        "lastName": "<string>",
        "source": "<string>",
        "groupIds": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ]
      },
      "reason": "<string>"
    }
  ],
  "number": 123,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "pageable": {
    "offset": 123,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "pageNumber": 123,
    "pageSize": 123,
    "paged": true,
    "unpaged": true
  },
  "numberOfElements": 123,
  "empty": true
}

Authorizations

Authorization

string

header

required

JWT token (USER, AGENT, or SERVICE auth)

Path Parameters

groupId

string<uuid>

required

Query Parameters

pageable

object

required

Show child attributes

Response

200 - */*

totalElements

integer<int64>

totalPages

integer<int32>

first

boolean

last

boolean

size

integer<int32>

content

object[]

Show child attributes

number

integer<int32>

sort

object

Show child attributes

pageable

object

Show child attributes

numberOfElements

integer<int32>

empty

boolean

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 all versions of a group (audit history)

Authorizations

Path Parameters

Query Parameters

Response