Create a new configuration

curl --request POST \
  --url https://api.example.com/v3/configurations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "value": true
}
'

import requests

url = "https://api.example.com/v3/configurations"

payload = {
    "name": "<string>",
    "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "value": True
}
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({
    name: '<string>',
    source_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    value: true
  })
};

fetch('https://api.example.com/v3/configurations', 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.example.com/v3/configurations",
  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([
    'name' => '<string>',
    'source_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'value' => true
  ]),
  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 := "https://api.example.com/v3/configurations"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\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("https://api.example.com/v3/configurations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v3/configurations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\n}"

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

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "source_name": "ORGANIZATION",
    "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "value": true,
    "is_secret": true,
    "is_system": true,
    "organization": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "group_name": "<string>",
    "created_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "jsmith@example.com",
      "full_name": "<string>"
    },
    "updated_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "jsmith@example.com",
      "full_name": "<string>"
    }
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

Configurations

Create a new configuration

Create a configuration for an organization, project, or model. Each setting can be created only once per scope; if it already exists, this endpoint returns 409 Conflict. A setting can exist before you first create it: on deployments where stored values take effect, Fiddler copies any retention value set as an environment variable into an organization-level configuration at startup. To change an existing value, find its id with the list endpoint and use the update endpoint.

description, is_secret, is_system, and group_name are filled in automatically.

Retention settings delete data. For PROD_EVENTS_TTL_DAYS set on a MODEL, the new retention period is applied to that model’s existing production events, and events older than the period are permanently deleted by background processes over the following hours. PROD_EVENTS_TTL_DAYS set on an ORGANIZATION or PROJECT applies only to models created afterward. The configuration is saved before the retention period is applied, so a successful response, or a GET that shows the value, confirms only that the configuration was saved, not that the retention period has been applied to stored data. If this request returns an error, the configuration may still have been saved: check with the list endpoint before retrying, and use the update endpoint if it exists.

POST

configurations

Create a new configuration

curl --request POST \
  --url https://api.example.com/v3/configurations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "value": true
}
'

import requests

url = "https://api.example.com/v3/configurations"

payload = {
    "name": "<string>",
    "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "value": True
}
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({
    name: '<string>',
    source_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    value: true
  })
};

fetch('https://api.example.com/v3/configurations', 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.example.com/v3/configurations",
  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([
    'name' => '<string>',
    'source_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'value' => true
  ]),
  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 := "https://api.example.com/v3/configurations"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\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("https://api.example.com/v3/configurations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/v3/configurations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"source_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"value\": true\n}"

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

{
  "api_version": "3.0",
  "kind": "NORMAL",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "source_name": "ORGANIZATION",
    "source_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "value": true,
    "is_secret": true,
    "is_system": true,
    "organization": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "description": "<string>",
    "group_name": "<string>",
    "created_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "jsmith@example.com",
      "full_name": "<string>"
    },
    "updated_by": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "email": "jsmith@example.com",
      "full_name": "<string>"
    }
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

{
  "api_version": "3.0",
  "kind": "ERROR",
  "error": {
    "code": 400,
    "message": "Resource Not Found",
    "errors": [
      {
        "reason": "ResourceNotFoundException",
        "message": "Resource Not Found",
        "help": "<string>"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

Name of the setting. The API accepts every registered setting. This reference documents the data retention settings below; contact your Fiddler Customer Success Manager before changing any other setting.

PROD_EVENTS_TTL_DAYS: retention period, in days, for ML model production events. Minimum 7. Can be set on an ORGANIZATION, PROJECT, or MODEL; the most specific scope wins.
GENAI_TRACES_TTL_DAYS: retention period, in days, for raw GenAI trace and span data. Minimum 7, unless your deployment sets a different minimum. ORGANIZATION scope only.
GENAI_METRICS_TTL_DAYS: retention period, in days, for pre-aggregated GenAI metrics. Minimum 60. ORGANIZATION scope only.

source_name

enum<string>

required

Scope the configuration applies to.

Available options:

ORGANIZATION,

PROJECT,

MODEL,

APPLICATION

source_id

string<uuid>

required

UUID of the organization, project, model, or application the configuration applies to, matching source_name. For ORGANIZATION, this is your organization's UUID, not its name or numeric ID.

value

required

Configuration value. The format depends on the configuration type (determined by the name field). The value must be one of:

Boolean: true or false (for BoolConfigValue)
Integer: 123 (for IntConfigValue)
Float: 123.45 (for FloatConfigValue)
String: "string" (for StringConfigValue)

The actual type is determined by the configuration name and validated against the config registry.

Response

Configuration created successfully

Response object for standard API responses.

api_version

enum<string>

default:3.0

API version.

Available options:

2.0,

3.0

kind

enum<string>

default:NORMAL

Type of response, indicating a normal response.

Available options:

NORMAL

data

object

Show child attributes

Fiddler Python Client SDK

Fiddler Evals SDK

Fiddler OTel SDK

Fiddler LangGraph SDK

Fiddler LangChain SDK

Fiddler Google ADK SDK

Fiddler Strands Agent SDK

Fiddler OTel JS SDK

Fiddler LangGraph JS SDK

Fiddler LangChain JS SDK

Create a new configuration

Authorizations

Body

Response