v3

OpenAPI 3.1.0MIT2026-07-31192456807.8 KB

ShadowExperimentService

Create a shadow experiment

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.

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

Path parameters

projectIdstring required

Project identifier.

endpointIdstring required

Endpoint identifier.

Request body

namestring required

Human-readable shadow experiment name, unique within the endpoint. At most 256 characters.

Response

idstring required

Output only. Unique shadow experiment identifier.

projectIdstring required

Output only. Project that owns the parent endpoint.

endpointIdstring required

Output only. Endpoint whose traffic this experiment samples.

namestring required

Human-readable shadow experiment name, unique within the endpoint. At most 256 characters.

descriptionstring

User defined description.

createdBystring required

Identifier of the principal that created the experiment.

createdAtstring date-time required

Timestamp when the experiment was created.

updatedAtstring date-time required

Timestamp when the experiment was last updated.

etagstring required

Opaque version tag for optimistic concurrency control. Returned on read; set it on update or delete requests for consistent read-modify-write.

state'SHADOW_EXPERIMENT_STATE_ACTIVE' | 'SHADOW_EXPERIMENT_STATE_INACTIVE' required

Derived serving state, active when the experiment has at least one target.