Documentation

docker run -d \
  --name scriptmesh-agent \
  --restart unless-stopped \
  -e AGENT_NAME=prod-server-1 \
  -e ORCHESTRATOR_URL=https://api.getscriptmesh.com \
  -e API_KEY=sm_live_YOUR_API_KEY \
  -v /path/to/scripts:/scripts \
  scriptmesh/agent:latest

curl -X POST https://api.getscriptmesh.com/register-agent \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "prod-server-1",
    "url": "https://prod-server-1.internal:8001",
    "api_key": "agent-key-here",
    "tags": ["production", "backend"]
  }'

# Response
{ "status": "ok", "agent": "prod-server-1" }

# Trigger async execution
curl -X POST https://api.getscriptmesh.com/trigger-script \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "prod-server-1",
    "run_script": "backup.sh",
    "params": { "target": "s3://my-bucket" },
    "async_exec": true
  }'

# Returns immediately with a job ID
{ "job_id": "job_a3f8c9d2", "status": "pending" }

# Poll the job result
curl https://api.getscriptmesh.com/jobs/job_a3f8c9d2 \
  -H "Authorization: Bearer $TOKEN"

# When complete
{
  "job_id": "job_a3f8c9d2",
  "status": "success",
  "exit_code": 0,
  "stdout": "Backup complete. 2.4GB archived to s3://my-bucket",
  "stderr": "",
  "duration_ms": 4231,
  "completed_at": "2026-03-10T14:32:11Z"
}

#!/bin/bash
# /scripts/backup.sh  — mounted into agent container
set -euo pipefail

TARGET="${target:-s3://my-backups/$(hostname)}"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
ARCHIVE="/tmp/backup_${TIMESTAMP}.tar.gz"

echo "Archiving /var/app/data to ${TARGET}/${TIMESTAMP}.tar.gz ..."
tar czf "$ARCHIVE" /var/app/data/

aws s3 cp "$ARCHIVE" "${TARGET}/${TIMESTAMP}.tar.gz" --storage-class STANDARD_IA
rm -f "$ARCHIVE"

echo "Done. Size: $(du -sh $ARCHIVE | cut -f1)"

# Repeat for each production agent
for AGENT in prod-us-east prod-eu-west prod-ap-south; do
  curl -X POST https://api.getscriptmesh.com/schedules \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "{
      \"agent\": \"$AGENT\",
      \"script\": \"backup.sh\",
      \"cron_expression\": \"0 2 * * *\",
      \"params\": { \"target\": \"s3://my-backups/$AGENT\" },
      \"webhook_url\": \"https://hooks.slack.com/services/...\"
    }"
done

#!/bin/bash
TOKEN="$SM_TOKEN"
VERSION="$1"

# Step 1: deploy to staging first
echo "→ Deploying $VERSION to staging..."
JOB=$(curl -s -X POST https://api.getscriptmesh.com/trigger-script \
  -H "Authorization: Bearer $TOKEN" \
  -d "{"agent":"staging-1","run_script":"deploy.sh",
       "params":{"version":"$VERSION"},"async_exec":true}" | jq -r '.job_id')

# Poll until complete (max 5 mins)
for i in $(seq 1 60); do
  STATUS=$(curl -s https://api.getscriptmesh.com/jobs/$JOB \
    -H "Authorization: Bearer $TOKEN" | jq -r '.status')
  [[ "$STATUS" != "pending" && "$STATUS" != "running" ]] && break
  sleep 5
done

if [[ "$STATUS" != "success" ]]; then
  echo "✗ Staging deploy failed — aborting production rollout"
  exit 1
fi

# Step 2: fan-out to all production agents
echo "✓ Staging OK → deploying $VERSION to production..."
for AGENT in prod-us-east prod-eu-west prod-ap-south; do
  curl -s -X POST https://api.getscriptmesh.com/trigger-script \
    -H "Authorization: Bearer $TOKEN" \
    -d "{"agent":"$AGENT","run_script":"deploy.sh",
         "params":{"version":"$VERSION"},"async_exec":true}" | \
    jq -r '"Triggered (.job_id) on $AGENT"'
done

# Create a PagerDuty integration first
curl -X POST https://api.getscriptmesh.com/integrations \
  -H "Authorization: Bearer $TOKEN" \
  -d '{
    "type": "pagerduty",
    "name": "fleet-alerts",
    "config": {
      "routing_key": "pd_live_...",
      "events": ["job.failed"]
    }
  }'

# Schedule health_check.py every 5 mins on each agent
for AGENT in prod-us-east prod-eu-west prod-ap-south; do
  curl -X POST https://api.getscriptmesh.com/schedules \
    -H "Authorization: Bearer $TOKEN" \
    -d "{
      \"agent\": \"$AGENT\",
      \"script\": \"health_check.py\",
      \"cron_expression\": \"*/5 * * * *\"
    }"
done

{
  "scripts": [
    {
      "name": "backup.sh",
      "path": "/scripts/backup.sh",
      "description": "Archive logs to S3"
    },
    {
      "name": "deploy.sh",
      "path": "/scripts/deploy.sh",
      "description": "Pull and restart latest container"
    },
    {
      "name": "health_check.py",
      "path": "/scripts/health_check.py",
      "description": "Check service endpoints"
    }
  ]
}

# Login
curl -X POST https://api.getscriptmesh.com/auth/login \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@company.com", "password": "your_password" }'

# Response
{
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "token_type": "bearer"
}

# Use in requests
curl https://api.getscriptmesh.com/agents \
  -H "Authorization: Bearer eyJhbGci..."

# Create a key
curl -X POST https://api.getscriptmesh.com/auth/api-keys \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "CI Pipeline", "expires_days": 90 }'

# Returns the raw key ONCE — store it securely
{
  "id": "key_...",
  "key": "sm_live_xyz...",
  "key_prefix": "sm_live_xyz",
  "warning": "Store this key securely. It will not be shown again."
}

curl -X POST https://api.getscriptmesh.com/schedules \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "prod-server-1",
    "script": "backup.sh",
    "cron_expression": "0 2 * * *",
    "params": { "target": "s3://my-bucket" },
    "webhook_url": "https://hooks.example.com/job-done",
    "timeout": 600
  }'

# Response
{
  "id": "sched_abc123",
  "cron_expression": "0 2 * * *",
  "next_fire": "2026-03-11T02:00:00Z"
}

curl -X POST https://api.getscriptmesh.com/integrations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "slack",
    "name": "ops-alerts",
    "config": {
      "webhook_url": "https://hooks.slack.com/services/...",
      "events": ["job.failed", "agent.offline"]
    }
  }'