Creates two comparable builds
/v0/builds/compare
Create two builds whose outputs can be directly compared with each other.
Created builds modify their project branches so that their latest sets of config files point to the ones specified by the input revision.
This endpoint is useful because a build has more inputs than the set of config files it uses, so comparing two builds directly may return spurious differences. Builds made via this endpoint are guaranteed to have differences arising from the set of config files, and any custom code.
Body Parameters
Returns
Creates two comparable builds
curl https://api.stainless.com/v0/builds/compare \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $STAINLESS_API_KEY" \
-d '{
"base": {
"branch": "branch",
"revision": "string"
},
"head": {
"branch": "branch",
"revision": "string"
},
"project": "project"
}'
{
"base": {
"id": "id",
"config_commit": "config_commit",
"created_at": "2019-12-27T18:11:19.117Z",
"documented_spec": {
"content": "content",
"type": "content"
},
"object": "build",
"org": "org",
"project": "project",
"targets": {
"cli": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"csharp": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"go": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"java": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"kotlin": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"node": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"php": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"python": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"ruby": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"terraform": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"typescript": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
}
},
"updated_at": "2019-12-27T18:11:19.117Z"
},
"head": {
"id": "id",
"config_commit": "config_commit",
"created_at": "2019-12-27T18:11:19.117Z",
"documented_spec": {
"content": "content",
"type": "content"
},
"object": "build",
"org": "org",
"project": "project",
"targets": {
"cli": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"csharp": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"go": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"java": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"kotlin": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"node": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"php": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"python": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"ruby": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"terraform": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"typescript": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
}
},
"updated_at": "2019-12-27T18:11:19.117Z"
}
}
Returns Examples
{
"base": {
"id": "id",
"config_commit": "config_commit",
"created_at": "2019-12-27T18:11:19.117Z",
"documented_spec": {
"content": "content",
"type": "content"
},
"object": "build",
"org": "org",
"project": "project",
"targets": {
"cli": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"csharp": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"go": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"java": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"kotlin": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"node": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"php": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"python": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"ruby": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"terraform": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"typescript": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
}
},
"updated_at": "2019-12-27T18:11:19.117Z"
},
"head": {
"id": "id",
"config_commit": "config_commit",
"created_at": "2019-12-27T18:11:19.117Z",
"documented_spec": {
"content": "content",
"type": "content"
},
"object": "build",
"org": "org",
"project": "project",
"targets": {
"cli": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"csharp": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"go": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"java": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"kotlin": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"node": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"php": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"python": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"ruby": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"terraform": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
},
"typescript": {
"commit": {
"status": "not_started"
},
"install_url": "install_url",
"lint": {
"status": "not_started"
},
"object": "build_target",
"status": "not_started",
"test": {
"status": "not_started"
},
"build": {
"status": "not_started"
}
}
},
"updated_at": "2019-12-27T18:11:19.117Z"
}
}