List enterprise control change history

Returns a paginated list of enterprise control setting changes for the organization, ordered by revision descending. Properties for the settings object may be added, removed, or renamed between API versions. Clients should parse it as a generic JSON object.

GET /api/v0/organization/enterprise-controls/history

List enterprise control change history

cURL

curl --request GET \
  --url https://api.factory.ai/api/v0/organization/enterprise-controls/history \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.factory.ai/api/v0/organization/enterprise-controls/history"

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

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

print(response.text)

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

fetch('https://api.factory.ai/api/v0/organization/enterprise-controls/history', 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.factory.ai/api/v0/organization/enterprise-controls/history",
  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.factory.ai/api/v0/organization/enterprise-controls/history"

	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))

}

HttpResponse<String> response = Unirest.get("https://api.factory.ai/api/v0/organization/enterprise-controls/history")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.factory.ai/api/v0/organization/enterprise-controls/history")

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

200

{
  "changes": [
    {
      "revision": 123,
      "settings": {
        "sessionDefaultSettings": {
          "model": "<string>",
          "specModeModel": "<string>"
        },
        "mcpAutonomyOverrides": {},
        "cloudSessionSync": true,
        "wikiCloudSync": true,
        "includeCoAuthoredByDroid": true,
        "enableDroidShield": true,
        "ideAutoConnect": true,
        "commandAllowlist": [
          "<string>"
        ],
        "commandDenylist": [
          "<string>"
        ],
        "customModels": [
          {
            "model": "<string>",
            "id": "<string>",
            "index": 123,
            "baseUrl": "<string>",
            "apiKey": "<string>",
            "displayName": "<string>",
            "maxContextLimit": 123,
            "enableThinking": true,
            "thinkingMaxTokens": 123,
            "maxOutputTokens": 123,
            "extraHeaders": {},
            "extraArgs": {},
            "noImageSupport": true,
            "bedrock": {
              "awsProfile": "<string>",
              "awsRegion": "<string>",
              "bedrockBaseUrl": "<string>",
              "awsAuthRefresh": "<string>",
              "awsCredentialExport": "<string>"
            }
          }
        ],
        "modelPolicy": {
          "allowedModelIds": [
            "<string>"
          ],
          "blockedModelIds": [
            "<string>"
          ],
          "allowCustomModels": true,
          "allowedBaseUrls": [
            "<string>"
          ],
          "allowAllFactoryModels": true,
          "isFastModelsAllowed": true
        },
        "mcpPolicy": {
          "enabled": false,
          "allowlist": [
            "<string>"
          ]
        },
        "missionPolicy": {
          "restrictedAccess": false,
          "allowedUserIds": [
            "<string>"
          ]
        },
        "userModelPolicies": {},
        "enabledPlugins": {},
        "extraKnownMarketplaces": {},
        "strictKnownMarketplaces": [
          {
            "source": "github",
            "repo": "<string>"
          }
        ],
        "networkPolicy": {
          "allowedIps": [
            "<string>"
          ]
        },
        "sandbox": {
          "enabled": true,
          "filesystem": {
            "allowWrite": [
              "<string>"
            ],
            "allowRead": [
              "<string>"
            ],
            "denyWrite": [
              "<string>"
            ],
            "denyRead": [
              "<string>"
            ]
          },
          "network": {
            "allowedDomains": [
              "<string>"
            ],
            "allowUnixSockets": [
              "<string>"
            ],
            "allowAllUnixSockets": true,
            "allowLocalBinding": true,
            "httpProxyPort": 123,
            "socksProxyPort": 123
          }
        },
        "restrictMemberVisibility": true,
        "restrictApiKeyCreationToManagers": true,
        "managedComputersEnabled": true,
        "managedComputersAllowedEmails": [
          "<string>"
        ],
        "byomComputersEnabled": true,
        "byomComputersAllowedEmails": [
          "<string>"
        ],
        "sessionRetentionDays": 189
      },
      "user": {
        "id": "<string>",
        "email": "<string>",
        "name": "<string>"
      },
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<string>"
  }
}

{
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "metadata": {}
}

{
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "metadata": {}
}

{
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "metadata": {}
}

{
  "detail": "<string>",
  "status": 123,
  "title": "<string>",
  "metadata": {}
}

Authorizations

Authorization · string · header · required

Factory API key or JWT token for authentication

Query Parameters

limit · string · default: 20

Maximum number of items to return (1-100)

cursor · string

Cursor for pagination

Response

200

application/json

Response for status 200

changes · object[] · required

List of enterprise control changes

Show child attributes

pagination · object · required

Show child attributes