Deploy agent | Astro AI | Documentation

Deploys the latest build of an agent to Kubernetes. Creates or updates the K8s namespace, deployment, services, and ingress. Returns 200 on full success or 207 if some resources had errors.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or platform session token

Request

This endpoint expects an object.

accountstringRequired

Account that owns the deployment

namestringRequired

Agent name

source_accountstringOptional

Source account for cross-account deploys (uses latest published version)

user_credentialsmap from strings to stringsOptional

Credential key-value pairs required by the agent

interfaceslist of stringsOptional

Interface adapter names to enable (e.g. [“slack”, “web”])

schedulesmap from strings to stringsOptional

Cron schedules keyed by ingestion name

Response

Deployment succeeded

statusenumOptional

namestringOptional

build_idstringOptional

k8s_namespacestringOptional

deployed_atdatetimeOptional

resourceslist of maps from strings to anyOptional

Kubernetes resources created or updated

service_endpointslist of objectsOptional

errorslist of stringsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://astropods.com/api/v1/deploy \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"account": "astro-team",
>	"name": "weather-agent"
>	}'

1	{
2	"status": "success",
3	"name": "weather-agent",
4	"build_id": "build-20240612-1530",
5	"k8s_namespace": "astro-weather-agent",
6	"deployed_at": "2024-06-12T15:30:00Z",
7	"resources": [
8	{}
9	],
10	"service_endpoints": [
11	{
12	"name": "weather-api",
13	"url": "https://weather.astro-team.svc.cluster.local",
14	"type": "ClusterIP"
15	}
16	],
17	"errors": []
18	}