Clusters
Applications
Models
Artifacts
- GETGet Artifact
- DELDelete Artifact
- GETList Artifacts
- GETGet Artifact Version
- DELDelete Artifact Version
- GETList Artifact Versions
- PUTApply Artifact Version
- POSTDelete Artifact Version
- POSTGet Signed Urls For Artifact Version
- POSTCreate Multi Part Upload
- POSTStage Artifact Version
- POSTList Files For Artifact Version
- POSTMark Stage Failure
Prompts
Secret Groups
Model Deployments
Users
Personal Access Tokens
Virtual Accounts
Applications
List Application Deployments
Fetch all deployments for a given application ID with optional filters such as deployment ID or version. Supports pagination.
GET
/
api
/
svc
/
v1
/
apps
/
{id}
/
deployments
curl --request GET \
--url https://{controlPlaneURL}/api/svc/v1/apps/{id}/deployments \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"id": "<string>",
"version": 123,
"fqn": "<string>",
"applicationId": "<string>",
"manifest": {
"name": "<string>",
"image": {
"type": "build",
"docker_registry": "<string>",
"build_source": {
"type": "remote",
"remote_uri": "<string>"
},
"build_spec": {
"type": "dockerfile",
"dockerfile_path": "<string>",
"build_context_path": "<string>",
"command": "<string>",
"build_args": {}
}
},
"artifacts_download": {
"cache_volume": {
"storage_class": "<string>",
"cache_size": 500
},
"artifacts": [
{
"type": "truefoundry-artifact",
"artifact_version_fqn": "<string>",
"download_path_env_variable": "<string>"
}
]
},
"resources": {
"cpu_request": 128.0005,
"cpu_limit": 128.0005,
"memory_request": 1000000,
"memory_limit": 1000000,
"ephemeral_storage_request": 1000000,
"ephemeral_storage_limit": 1000000,
"shared_memory_size": 1000032,
"node": {
"type": "node_selector",
"instance_families": [
"<string>"
],
"capacity_type": "spot_fallback_on_demand"
},
"devices": [
{
"type": "nvidia_gpu",
"name": "<string>",
"count": 8
}
]
},
"env": null,
"ports": [
{
"port": 32768,
"protocol": "TCP",
"expose": true,
"app_protocol": "http",
"host": "<string>",
"path": "<string>",
"rewrite_path_to": "<string>",
"auth": {
"type": "basic_auth",
"username": "<string>",
"password": "<string>"
}
}
],
"service_account": "<string>",
"mounts": [
{
"type": "secret",
"mount_path": "<string>",
"secret_fqn": "<string>"
}
],
"labels": {},
"kustomize": {
"patch": {},
"additions": [
{}
]
},
"liveness_probe": {
"config": {
"type": "http",
"path": "<string>",
"port": 32767,
"host": "<string>",
"scheme": "<string>"
},
"initial_delay_seconds": 18000,
"period_seconds": 18000,
"timeout_seconds": 18000,
"success_threshold": 50,
"failure_threshold": 50
},
"readiness_probe": {
"config": {
"type": "http",
"path": "<string>",
"port": 32767,
"host": "<string>",
"scheme": "<string>"
},
"initial_delay_seconds": 18000,
"period_seconds": 18000,
"timeout_seconds": 18000,
"success_threshold": 50,
"failure_threshold": 50
},
"workspace_fqn": "<string>",
"type": "service",
"replicas": 250,
"auto_shutdown": {
"wait_time": 1
},
"allow_interception": false,
"rollout_strategy": {
"type": "rolling_update",
"max_unavailable_percentage": 50,
"max_surge_percentage": 50
}
},
"application": {
"id": "<string>",
"fqn": "<string>",
"name": "<string>",
"type": "async-service",
"createdBySubject": {
"subjectId": "<string>",
"subjectType": "user",
"subjectSlug": "<string>",
"subjectDisplayName": "<string>"
},
"tenantName": "<string>",
"metadata": {
"paused": true
},
"lifecycleStage": "active",
"workspaceId": "<string>",
"lastVersion": 123,
"activeVersion": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"recommendations": [
{
"id": "<string>",
"clusterId": "<string>",
"applicationId": "<string>",
"deploymentId": "<string>",
"applicationVersion": 123,
"recommendationData": {},
"recommendationType": "<string>",
"appliedDeploymentId": "<string>",
"expiryTimestamp": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"alerts": [
{
"id": "<string>",
"name": "<string>",
"timestamps": [
"2023-11-07T05:31:56Z"
],
"startTime": "2023-11-07T05:31:56Z",
"resolvedTime": "2023-11-07T05:31:56Z",
"applicationId": "<string>",
"clusterId": "<string>",
"tenantName": "<string>",
"fingerprint": "<string>",
"updatedAt": "<string>",
"createdAt": "<string>",
"applicationDebugInfoId": "<string>"
}
],
"alertsSummary": {},
"applicationDebugInfos": [
{
"id": "<string>",
"applicationId": "<string>",
"application": {},
"debugInfo": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"potentialProblems": [
{
"name": "<string>",
"description": "<string>"
}
],
"autopilot": {},
"createdBy": "<string>",
"deployment": {},
"activeDeploymentId": "<string>",
"lastDeploymentId": "<string>"
},
"createdBySubject": {
"subjectId": "<string>",
"subjectType": "user",
"subjectSlug": "<string>",
"subjectDisplayName": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deploymentBuilds": [
{
"name": "<string>",
"status": 20
}
],
"deploymentStatuses": [
{
"id": "<string>",
"deploymentId": "<string>",
"status": "INITIALIZED",
"state": {},
"transition": "BUILDING",
"message": "<string>",
"retryCount": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"currentStatusId": "<string>",
"currentStatus": {
"id": "<string>",
"deploymentId": "<string>",
"status": "INITIALIZED",
"state": {},
"transition": "BUILDING",
"message": "<string>",
"retryCount": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"appliedRecommendations": [
{
"id": "<string>",
"clusterId": "<string>",
"applicationId": "<string>",
"deploymentId": "<string>",
"applicationVersion": 123,
"recommendationData": {},
"recommendationType": "<string>",
"appliedDeploymentId": "<string>",
"expiryTimestamp": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"createdBy": "<string>"
}
],
"pagination": {
"total": 100,
"offset": 0,
"limit": 10
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Id of the application
Query Parameters
Number of items per page
Required range:
1 <= x <= 1000
Example:
10
Number of items to skip
Required range:
x >= 0
Example:
0
Deployment version. Filter deployments by version.
Example:
"1"
Deployment ID. Filter deployments by a specific ID.
Example:
"deployment123"
Response
200
application/json
List of deployments matching the provided filters.
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://{controlPlaneURL}/api/svc/v1/apps/{id}/deployments \
--header 'Authorization: Bearer <token>'
{
"data": [
{
"id": "<string>",
"version": 123,
"fqn": "<string>",
"applicationId": "<string>",
"manifest": {
"name": "<string>",
"image": {
"type": "build",
"docker_registry": "<string>",
"build_source": {
"type": "remote",
"remote_uri": "<string>"
},
"build_spec": {
"type": "dockerfile",
"dockerfile_path": "<string>",
"build_context_path": "<string>",
"command": "<string>",
"build_args": {}
}
},
"artifacts_download": {
"cache_volume": {
"storage_class": "<string>",
"cache_size": 500
},
"artifacts": [
{
"type": "truefoundry-artifact",
"artifact_version_fqn": "<string>",
"download_path_env_variable": "<string>"
}
]
},
"resources": {
"cpu_request": 128.0005,
"cpu_limit": 128.0005,
"memory_request": 1000000,
"memory_limit": 1000000,
"ephemeral_storage_request": 1000000,
"ephemeral_storage_limit": 1000000,
"shared_memory_size": 1000032,
"node": {
"type": "node_selector",
"instance_families": [
"<string>"
],
"capacity_type": "spot_fallback_on_demand"
},
"devices": [
{
"type": "nvidia_gpu",
"name": "<string>",
"count": 8
}
]
},
"env": null,
"ports": [
{
"port": 32768,
"protocol": "TCP",
"expose": true,
"app_protocol": "http",
"host": "<string>",
"path": "<string>",
"rewrite_path_to": "<string>",
"auth": {
"type": "basic_auth",
"username": "<string>",
"password": "<string>"
}
}
],
"service_account": "<string>",
"mounts": [
{
"type": "secret",
"mount_path": "<string>",
"secret_fqn": "<string>"
}
],
"labels": {},
"kustomize": {
"patch": {},
"additions": [
{}
]
},
"liveness_probe": {
"config": {
"type": "http",
"path": "<string>",
"port": 32767,
"host": "<string>",
"scheme": "<string>"
},
"initial_delay_seconds": 18000,
"period_seconds": 18000,
"timeout_seconds": 18000,
"success_threshold": 50,
"failure_threshold": 50
},
"readiness_probe": {
"config": {
"type": "http",
"path": "<string>",
"port": 32767,
"host": "<string>",
"scheme": "<string>"
},
"initial_delay_seconds": 18000,
"period_seconds": 18000,
"timeout_seconds": 18000,
"success_threshold": 50,
"failure_threshold": 50
},
"workspace_fqn": "<string>",
"type": "service",
"replicas": 250,
"auto_shutdown": {
"wait_time": 1
},
"allow_interception": false,
"rollout_strategy": {
"type": "rolling_update",
"max_unavailable_percentage": 50,
"max_surge_percentage": 50
}
},
"application": {
"id": "<string>",
"fqn": "<string>",
"name": "<string>",
"type": "async-service",
"createdBySubject": {
"subjectId": "<string>",
"subjectType": "user",
"subjectSlug": "<string>",
"subjectDisplayName": "<string>"
},
"tenantName": "<string>",
"metadata": {
"paused": true
},
"lifecycleStage": "active",
"workspaceId": "<string>",
"lastVersion": 123,
"activeVersion": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"recommendations": [
{
"id": "<string>",
"clusterId": "<string>",
"applicationId": "<string>",
"deploymentId": "<string>",
"applicationVersion": 123,
"recommendationData": {},
"recommendationType": "<string>",
"appliedDeploymentId": "<string>",
"expiryTimestamp": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"alerts": [
{
"id": "<string>",
"name": "<string>",
"timestamps": [
"2023-11-07T05:31:56Z"
],
"startTime": "2023-11-07T05:31:56Z",
"resolvedTime": "2023-11-07T05:31:56Z",
"applicationId": "<string>",
"clusterId": "<string>",
"tenantName": "<string>",
"fingerprint": "<string>",
"updatedAt": "<string>",
"createdAt": "<string>",
"applicationDebugInfoId": "<string>"
}
],
"alertsSummary": {},
"applicationDebugInfos": [
{
"id": "<string>",
"applicationId": "<string>",
"application": {},
"debugInfo": {},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"potentialProblems": [
{
"name": "<string>",
"description": "<string>"
}
],
"autopilot": {},
"createdBy": "<string>",
"deployment": {},
"activeDeploymentId": "<string>",
"lastDeploymentId": "<string>"
},
"createdBySubject": {
"subjectId": "<string>",
"subjectType": "user",
"subjectSlug": "<string>",
"subjectDisplayName": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"deploymentBuilds": [
{
"name": "<string>",
"status": 20
}
],
"deploymentStatuses": [
{
"id": "<string>",
"deploymentId": "<string>",
"status": "INITIALIZED",
"state": {},
"transition": "BUILDING",
"message": "<string>",
"retryCount": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"currentStatusId": "<string>",
"currentStatus": {
"id": "<string>",
"deploymentId": "<string>",
"status": "INITIALIZED",
"state": {},
"transition": "BUILDING",
"message": "<string>",
"retryCount": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"appliedRecommendations": [
{
"id": "<string>",
"clusterId": "<string>",
"applicationId": "<string>",
"deploymentId": "<string>",
"applicationVersion": 123,
"recommendationData": {},
"recommendationType": "<string>",
"appliedDeploymentId": "<string>",
"expiryTimestamp": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"createdBy": "<string>"
}
],
"pagination": {
"total": 100,
"offset": 0,
"limit": 10
}
}
Assistant
Responses are generated using AI and may contain mistakes.