List agent optimization runs

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Get the most recent result for each unique run of an agent optimization.

GET /api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/results

List agent optimization runs

cURL

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/projects/{projectKey}/agent-optimizations/{optimizationKey}/results \
  --header 'Authorization: <api-key>'

200

{
  "_links": {
    "next": {
      "href": "href",
      "type": "type"
    },
    "last": {
      "href": "href",
      "type": "type"
    },
    "prev": {
      "href": "href",
      "type": "type"
    },
    "self": {
      "href": "href",
      "type": "type"
    },
    "first": {
      "href": "href",
      "type": "type"
    }
  },
  "totalCount": 7,
  "items": [
    {
      "instructions": "instructions",
      "generationTokens": {
        "key": ""
      },
      "completedAt": 5,
      "activity": "PENDING",
      "_links": {
        "parent": {
          "href": "href",
          "type": "type"
        },
        "self": {
          "href": "href",
          "type": "type"
        }
      },
      "scores": {
        "key": ""
      },
      "variation": {
        "key": ""
      },
      "evaluationLatencies": {
        "key": ""
      },
      "createdVariationKey": "createdVariationKey",
      "evaluationTokens": {
        "key": ""
      },
      "createdAt": 5,
      "agentOptimizationId": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "generationLatency": 1,
      "_access": {
        "allowed": [
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          },
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          }
        ],
        "denied": [
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          },
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          }
        ]
      },
      "agentOptimizationVersion": 0,
      "completionResponse": "completionResponse",
      "iteration": 6,
      "id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "runId": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "userInput": "userInput",
      "parameters": {
        "key": ""
      },
      "status": "RUNNING",
      "updatedAt": 2
    },
    {
      "instructions": "instructions",
      "generationTokens": {
        "key": ""
      },
      "completedAt": 5,
      "activity": "PENDING",
      "_links": {
        "parent": {
          "href": "href",
          "type": "type"
        },
        "self": {
          "href": "href",
          "type": "type"
        }
      },
      "scores": {
        "key": ""
      },
      "variation": {
        "key": ""
      },
      "evaluationLatencies": {
        "key": ""
      },
      "createdVariationKey": "createdVariationKey",
      "evaluationTokens": {
        "key": ""
      },
      "createdAt": 5,
      "agentOptimizationId": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "generationLatency": 1,
      "_access": {
        "allowed": [
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          },
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          }
        ],
        "denied": [
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          },
          {
            "reason": {
              "role_name": "role_name",
              "notActions": [
                null,
                null
              ],
              "notResources": [
                "notResources",
                "notResources"
              ],
              "effect": "allow",
              "resources": [
                "proj/*:env/*;qa_*:/flag/*"
              ],
              "actions": [
                "*"
              ]
            },
            "action": "action"
          }
        ]
      },
      "agentOptimizationVersion": 0,
      "completionResponse": "completionResponse",
      "iteration": 6,
      "id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "runId": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "userInput": "userInput",
      "parameters": {
        "key": ""
      },
      "status": "RUNNING",
      "updatedAt": 2
    }
  ]
}

Authorizations

Authorization · string · header · required

Path Parameters

projectKey · string · required

optimizationKey · string · required

Query Parameters

limit · integer

The number of resources to return.

offset · integer

Where to start in the list. Use this with pagination. For example, an offset of 10 skips the first ten items and then returns the next items in the list, up to the query limit.

Response

200

application/json

Agent optimization results list

items · object[] · required

Show child attributes

_links · object

Show child attributes

Example:

{
  "next": { "href": "href", "type": "type" },
  "last": { "href": "href", "type": "type" },
  "prev": { "href": "href", "type": "type" },
  "self": { "href": "href", "type": "type" },
  "first": { "href": "href", "type": "type" }
}

totalCount · integer