v1

latestOpenAPI 3.0.1Gremlin License2026-08-06397451577.0 KB
failure-flags.experiments

Create an Experiment.

Requires the privilege EXPERIMENTS_WRITE

post/failure-flags/experiments

Query parameters

teamIdstring required

Required when using company session token.

Request body

idstring
teamIdstring
namestring required
staticTargetingboolean
durationstring required

The duration expressed as a variant of ISO 8601 with the following simplifications:

  1. no leading 'PT' (eg. 5m or 10h)
  2. valid time units are exclusively: m, h, d, s
ratenumber float
effectobject
createdAtstring date-time
startTimestring date-time
protectedboolean

Example request

{
  "app": {
    "labels": {
      "foo": [
        "bar",
        "baz"
      ]
    },
    "runtimeLabels": {
      "zones": [
        "us-west-1a",
        "us-west-1b"
      ]
    }
  },
  "flag": {
    "labels": {
      "foo": [
        "bar",
        "baz"
      ]
    },
    "runtimeLabels": {
      "zones": [
        "us-west-1a",
        "us-west-1b"
      ]
    }
  },
  "duration": "30m"
}

Response

Create an Experiment

idstring
teamIdstring
namestring required
staticTargetingboolean
durationstring required

The duration expressed as a variant of ISO 8601 with the following simplifications:

  1. no leading 'PT' (eg. 5m or 10h)
  2. valid time units are exclusively: m, h, d, s
ratenumber float
effectobject
createdAtstring date-time
startTimestring date-time
protectedboolean

Example response

{
  "app": {
    "labels": {
      "foo": [
        "bar",
        "baz"
      ]
    },
    "runtimeLabels": {
      "zones": [
        "us-west-1a",
        "us-west-1b"
      ]
    }
  },
  "flag": {
    "labels": {
      "foo": [
        "bar",
        "baz"
      ]
    },
    "runtimeLabels": {
      "zones": [
        "us-west-1a",
        "us-west-1b"
      ]
    }
  },
  "duration": "30m"
}