curl -X GET "https://app.runtm.com/api/v0/deployments/search?q=payment&state=ready" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/search",
headers={"Authorization": "Bearer runtm_xxx"},
params={
"q": "payment",
"state": "ready",
"template": "backend-service"
}
)
data = response.json()
for result in data["results"]:
print(f"{result['name']} (score: {result['match_score']})")
const params = new URLSearchParams({
q: "payment",
state: "ready",
template: "backend-service"
});
const response = await fetch(
`https://app.runtm.com/api/v0/deployments/search?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.results.forEach(result => {
console.log(`${result.name} (score: ${result.match_score})`);
});
{
"results": [
{
"deployment_id": "dep_abc123xyz",
"name": "stripe-webhook",
"state": "ready",
"url": "https://stripe-webhook-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 2,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"match_score": 1.8,
"discovery": {
"description": "Stripe webhook handler that processes payment events in real-time.",
"summary": "Real-time Stripe payment webhook processor",
"tags": ["stripe", "webhook", "payments", "api"],
"capabilities": [
"Process Stripe webhook events",
"Update order status in database"
]
}
}
],
"total": 1,
"query": "payment"
}
Deployments
Search Deployments
Search deployments by discovery metadata
GET
/
v0
/
deployments
/
search
curl -X GET "https://app.runtm.com/api/v0/deployments/search?q=payment&state=ready" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/search",
headers={"Authorization": "Bearer runtm_xxx"},
params={
"q": "payment",
"state": "ready",
"template": "backend-service"
}
)
data = response.json()
for result in data["results"]:
print(f"{result['name']} (score: {result['match_score']})")
const params = new URLSearchParams({
q: "payment",
state: "ready",
template: "backend-service"
});
const response = await fetch(
`https://app.runtm.com/api/v0/deployments/search?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.results.forEach(result => {
console.log(`${result.name} (score: ${result.match_score})`);
});
{
"results": [
{
"deployment_id": "dep_abc123xyz",
"name": "stripe-webhook",
"state": "ready",
"url": "https://stripe-webhook-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 2,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"match_score": 1.8,
"discovery": {
"description": "Stripe webhook handler that processes payment events in real-time.",
"summary": "Real-time Stripe payment webhook processor",
"tags": ["stripe", "webhook", "payments", "api"],
"capabilities": [
"Process Stripe webhook events",
"Update order status in database"
]
}
}
],
"total": 1,
"query": "payment"
}
Search deployments by description, summary, tags, capabilities, and use cases defined in
runtm.discovery.yaml.
Query Parameters
string
required
Search query (searches description, summary, tags, capabilities, use_cases, and name)
string
Filter by state:
queued, building, deploying, ready, failed, destroyedstring
Filter by template:
backend-service, static-site, web-appinteger
default:"20"
Maximum results (1-100)
Response
array
integer
Total matching results
string
The search query used
curl -X GET "https://app.runtm.com/api/v0/deployments/search?q=payment&state=ready" \
-H "Authorization: Bearer runtm_xxx"
import requests
response = requests.get(
"https://app.runtm.com/api/v0/deployments/search",
headers={"Authorization": "Bearer runtm_xxx"},
params={
"q": "payment",
"state": "ready",
"template": "backend-service"
}
)
data = response.json()
for result in data["results"]:
print(f"{result['name']} (score: {result['match_score']})")
const params = new URLSearchParams({
q: "payment",
state: "ready",
template: "backend-service"
});
const response = await fetch(
`https://app.runtm.com/api/v0/deployments/search?${params}`,
{
headers: {
"Authorization": "Bearer runtm_xxx"
}
}
);
const data = await response.json();
data.results.forEach(result => {
console.log(`${result.name} (score: ${result.match_score})`);
});
{
"results": [
{
"deployment_id": "dep_abc123xyz",
"name": "stripe-webhook",
"state": "ready",
"url": "https://stripe-webhook-abc123.fly.dev",
"template": "backend-service",
"runtime": "python",
"version": 2,
"is_latest": true,
"created_at": "2024-01-15T10:30:00Z",
"match_score": 1.8,
"discovery": {
"description": "Stripe webhook handler that processes payment events in real-time.",
"summary": "Real-time Stripe payment webhook processor",
"tags": ["stripe", "webhook", "payments", "api"],
"capabilities": [
"Process Stripe webhook events",
"Update order status in database"
]
}
}
],
"total": 1,
"query": "payment"
}
Search results are ranked by relevance. Exact tag matches score highest, followed by summary, description, capabilities, use cases, and name matches.