API Documentation

import requests

response = requests.get(
    "https://api.maidepot.com/api/v1/tokens/current",
    headers={"Authorization": "Bearer maid_..."}
)

print(response.json())

import requests

response = requests.get(
    "https://api.maidepot.com/api/v1/prompts",
    headers={"Authorization": "Bearer maid_..."}
)

prompts = response.json()["data"]
print(prompts)

curl -X POST "https://api.maidepot.com/api/v1/files/upload" \
  -H "Authorization: Bearer maid_..." \
  -F "file=@document.pdf"

API_TOKEN="maid_..."
BASE_URL="https://api.maidepot.com/api/v1"

# 1. Execute prompt
RESPONSE=$(curl -X POST "$BASE_URL/prompts/KXJmXkjeUnh2ziK1JREA/run" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"THING": "a beautiful sunset"}}')

TRANSACTION_ID=$(echo $RESPONSE | jq -r '.id')

# 2. Poll for result
while true; do
  STATUS_RESPONSE=$(curl -s "$BASE_URL/transactions/$TRANSACTION_ID" \
    -H "Authorization: Bearer $API_TOKEN")
  
  STATUS=$(echo $STATUS_RESPONSE | jq -r '.status')
  
  if [ "$STATUS" = "done" ]; then
    echo "Result: $(echo $STATUS_RESPONSE | jq '.result')"
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Error: $(echo $STATUS_RESPONSE | jq '.error')"
    break
  fi
  
  sleep 5
done

API_TOKEN="maid_..."
BASE_URL="https://api.maidepot.com/api/v1"
PROMPT_ID="3l5gXVtFs4LS0eqk2Bmn"

# 1. Upload file
UPLOAD_RESPONSE=$(curl -X POST "$BASE_URL/files/upload" \
  -H "Authorization: Bearer $API_TOKEN" \
  -F "file=@document.pdf")

GS_PATH=$(echo $UPLOAD_RESPONSE | jq -r '.gs_path')

# 2. Execute prompt with file
EXEC_PAYLOAD=$(jq -n \
  --arg gs_path "$GS_PATH" \
  '{inputs: {DOCUMENT: {file_url: $gs_path, content_type: "application/pdf", ocr_mode: "advanced"}, LANGUAGE: "Spanish"}}')

RESPONSE=$(curl -X POST "$BASE_URL/prompts/$PROMPT_ID/run" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$EXEC_PAYLOAD")

TRANSACTION_ID=$(echo $RESPONSE | jq -r '.id')

# 3. Poll for result
while true; do
  STATUS_RESPONSE=$(curl -s "$BASE_URL/transactions/$TRANSACTION_ID" \
    -H "Authorization: Bearer $API_TOKEN")
  STATUS=$(echo $STATUS_RESPONSE | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo "Result: $(echo $STATUS_RESPONSE | jq '.result')"
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Error: $(echo $STATUS_RESPONSE | jq '.error')"
    break
  fi
  sleep 5
done

API_TOKEN="maid_..."
BASE_URL="https://api.maidepot.com/api/v1"
PROMPT_ID="KXJmXkjeUnh2ziK1JREA"

# 1. Execute with webhook
curl -X POST "$BASE_URL/prompts/$PROMPT_ID/run" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"THING": "a sunset"}, "webhook_url": "https://your-domain.com/webhook"}'

# 2. Your webhook endpoint receives POST when done
# No polling needed - webhook is called automatically

API_TOKEN="maid_..."
BASE_URL="https://api.maidepot.com/api/v1"

# 1. Get failed transactions
FAILED_RESPONSE=$(curl -s "$BASE_URL/transactions?status=failed&limit=10" \
  -H "Authorization: Bearer $API_TOKEN")
FAILED_TXS=$(echo $FAILED_RESPONSE | jq -r '.data[]')

# 2. Retry each failed transaction
echo "$FAILED_TXS" | jq -c '.' 2>/dev/null | while read -r tx; do
  TX_ID=$(echo $tx | jq -r '.id')
  echo "Retrying $TX_ID"
  curl -X POST "$BASE_URL/transactions/$TX_ID/retry" \
    -H "Authorization: Bearer $API_TOKEN"
  sleep 10
  STATUS_RESPONSE=$(curl -s "$BASE_URL/transactions/$TX_ID" \
    -H "Authorization: Bearer $API_TOKEN")
  echo "  Status: $(echo $STATUS_RESPONSE | jq -r '.status')"
done

API_TOKEN="maid_..."
BASE_URL="https://api.maidepot.com/api/v1"

fetch_all_transactions() {
  local status=$1
  all_transactions="[]"
  after=""
  while true; do
    if [ -n "$after" ]; then
      url="$BASE_URL/transactions?limit=100&order=desc&after=$after"
    else
      url="$BASE_URL/transactions?limit=100&order=desc"
    fi
    [ -n "$status" ] && url="$url&status=$status"
    response=$(curl -s "$url" -H "Authorization: Bearer $API_TOKEN")
    data=$(echo $response | jq -c '.')
    all_transactions=$(echo $all_transactions | jq -s "add + ($data.data // [])")
    has_more=$(echo $response | jq -r '.has_more')
    if [ "$has_more" != "true" ]; then
      break
    fi
    after=$(echo $response | jq -r '.last_id')
  done
  echo $all_transactions
}

DONE_TXS=$(fetch_all_transactions "done")
echo "Total done transactions: $(echo $DONE_TXS | jq 'length')"

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook', methods=['POST'])
def webhook():
    event = request.headers.get('X-Webhook-Event')
    transaction_id = request.headers.get('X-Transaction-Id')
    
    payload = request.json
    
    if event == 'transaction.completed':
        status = payload['status']
        
        if status == 'done':
            result = payload['result']
            print(f"✓ Transaction {transaction_id} completed")
            print(f"  Result type: {result['type']}")
            print(f"  Credits used: {payload['credits_used']}")
        
        elif status == 'failed':
            error = payload['error']
            print(f"✗ Transaction {transaction_id} failed")
            print(f"  Error: {error['message']}")
    
    return jsonify({"received": True}), 200