Together AI API
Together AI DocsGet an API key
HomeAPI ReferenceSDKsContext Plugin
Shadow Experiment Service

List shadow experiments

GET
/projects/{projectId}/endpoints/{endpointId}/shadowExperiments

Lists experiments that mirror sampled endpoint traffic to target deployments without affecting client responses. Set includeTargets=true to include target details inline.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

projectId*string

Project identifier.

endpointId*string

Endpoint identifier.

Query Parameters

limit?integer

Maximum number of shadow experiments to return. Max 500, defaults to 50.

after?string

Cursor from a previous shadow experiment list response.

includeTargets?boolean

Whether to include target deployments in each returned shadow experiment.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/projects/string/endpoints/string/shadowExperiments"
{  "data": [    {      "id": "string",      "projectId": "string",      "endpointId": "string",      "name": "string",      "description": "string",      "source": {        "endpoint": {          "sampling": {            "uniform": {              "rate": 0            }          }        }      },      "targets": [        {          "id": "string",          "experimentId": "string",          "name": "string",          "targetDeploymentId": "string",          "description": "string",          "createdAt": "2019-08-24T14:15:22Z",          "updatedAt": "2019-08-24T14:15:22Z",          "etag": "string"        }      ],      "createdBy": "string",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "etag": "string",      "state": "SHADOW_EXPERIMENT_STATE_ACTIVE"    }  ],  "next_cursor": "string",  "object": "list"}

Delete an A/B experiment DELETE

Deletes an A/B experiment and removes its managed traffic split. The deployments themselves are not deleted.

Create a shadow experiment POST

Creates an experiment that mirrors a sampled portion of endpoint traffic to one or more target deployments without returning their responses to clients. Add a description with the update operation after creation.