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 session token from WorkOS

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

statusenum or null

Allowed values:

namestring or null

build_idstring or null

k8s_namespacestring or null

deployed_atdatetime or null

resourceslist of maps from strings to any or null

Kubernetes resources created or updated

service_endpointslist of objects or null

errorslist of strings or null

1	import requests
2
3	url = "https://api.astropod.ai/api/v1/deploy"
4
5	payload = {
6	"account": "astro-enterprise",
7	"name": "weather-agent"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

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

Authentication

Request

Response

Errors