@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/omnikit-redirects.json

@@ -0,0 +1,209 @@
+{
+  "slug": "omnikit-redirects",
+  "name": "OmniKit Redirects",
+  "description": "URL shortening and redirect management with analytics tracking",
+  "logo": "https://cdn.omnikit.co/cdn/project-10/public/10_1770556267491_eecb0n/603050903_10162713420734412_6016628635295692734_n.jpg",
+  "categories": [
+    "redirects",
+    "url-shortener",
+    "links",
+    "analytics"
+  ],
+  "base_url": "https://api.omnikit.co",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "API Key"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "create",
+      "description": "Create a new URL redirect with optional title, description, and expiration",
+      "method": "POST",
+      "path": "/redirects",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string",
+            "description": "The short URL slug (alphanumeric, hyphens, underscores only)"
+          },
+          "target": {
+            "type": "string",
+            "description": "The target URL to redirect to (must be http or https)"
+          },
+          "title": {
+            "type": "string",
+            "description": "Optional title for the redirect (max 500 chars)"
+          },
+          "description": {
+            "type": "string",
+            "description": "Optional description for the redirect"
+          },
+          "expires_at": {
+            "type": "string",
+            "description": "Optional expiration date (ISO 8601 format)"
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Whether the redirect is active",
+            "default": true
+          }
+        },
+        "required": [
+          "slug",
+          "target"
+        ]
+      }
+    },
+    {
+      "name": "list",
+      "description": "List all redirects with filtering, sorting, and pagination support",
+      "method": "GET",
+      "path": "/redirects",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "is_active": {
+            "type": "boolean",
+            "description": "Filter by active/inactive status"
+          },
+          "search": {
+            "type": "string",
+            "description": "Search in slug, title, and description"
+          },
+          "sort_field": {
+            "type": "string",
+            "description": "Field to sort by",
+            "enum": [
+              "id",
+              "slug",
+              "title",
+              "click_count",
+              "created_at",
+              "updated_at",
+              "last_clicked_at"
+            ],
+            "default": "created_at"
+          },
+          "sort_direction": {
+            "type": "string",
+            "description": "Sort direction",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of results (1-1000)",
+            "default": 20
+          },
+          "offset": {
+            "type": "integer",
+            "description": "Number of results to skip",
+            "default": 0
+          }
+        }
+      }
+    },
+    {
+      "name": "update",
+      "description": "Update an existing redirect. Slug cannot be changed.",
+      "method": "PUT",
+      "path": "/redirects/%7B%7Bid%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The redirect ID to update"
+          },
+          "target": {
+            "type": "string",
+            "description": "New target URL"
+          },
+          "title": {
+            "type": "string",
+            "description": "New title"
+          },
+          "description": {
+            "type": "string",
+            "description": "New description"
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Set active/inactive status"
+          },
+          "expires_at": {
+            "type": "string",
+            "description": "New expiration date (ISO 8601) or null to remove"
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "resolve",
+      "description": "Resolve a slug to its target URL and track the click",
+      "method": "POST",
+      "path": "/redirects/resolve",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string",
+            "description": "The redirect slug to resolve"
+          }
+        },
+        "required": [
+          "slug"
+        ]
+      }
+    },
+    {
+      "name": "analytics",
+      "description": "Get analytics and statistics for redirects including total clicks, top performers, and per-redirect stats",
+      "method": "GET",
+      "path": "/redirects/analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "redirect_ids": {
+            "type": "array",
+            "description": "Optional list of specific redirect IDs to analyze",
+            "items": {
+              "type": "string"
+            }
+          },
+          "time_range": {
+            "type": "object",
+            "description": "Optional time range filter",
+            "properties": {
+              "start": {
+                "type": "string",
+                "description": "Start date (ISO 8601)"
+              },
+              "end": {
+                "type": "string",
+                "description": "End date (ISO 8601)"
+              }
+            }
+          }
+        }
+      }
+    }
+  ]
+}

package/src/apps/omnikit-webhooks.json

@@ -0,0 +1,269 @@
+{
+  "slug": "omnikit-webhooks",
+  "name": "OmniKit Webhooks",
+  "description": "Register webhooks to receive real-time event notifications. AI agents can subscribe to platform events (user actions, payments, emails, etc.) and receive them at their HTTP endpoints.",
+  "logo": "https://cdn.omnikit.co/cdn/project-10/public/10_1770556267491_eecb0n/603050903_10162713420734412_6016628635295692734_n.jpg",
+  "categories": [
+    "webhooks",
+    "events",
+    "realtime",
+    "notifications",
+    "subscriptions"
+  ],
+  "base_url": "https://api.omnikit.co",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "API Key"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "omnikit_webhook_register",
+      "description": "Register a webhook to receive events at your HTTP endpoint. When matching events occur, they will be POSTed to your endpoint_url with signature verification.",
+      "method": "POST",
+      "path": "/webhooks-register",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization_id": {
+            "type": "integer",
+            "description": "Organization ID for organization-wide webhooks (receives events from ALL projects in the org). Use this OR project_id, not both."
+          },
+          "name": {
+            "type": "string",
+            "description": "Friendly name for this webhook (e.g., 'My Agent Events')"
+          },
+          "endpoint_url": {
+            "type": "string",
+            "description": "Your HTTP endpoint URL that will receive webhook POSTs (must be HTTPS in production)"
+          },
+          "event_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Event types to subscribe to (e.g., ['user.created', 'order.completed']). Use ['*'] for all events."
+          },
+          "direction": {
+            "type": "string",
+            "enum": [
+              "outgoing"
+            ],
+            "description": "Webhook direction - always 'outgoing' for agent subscriptions",
+            "default": "outgoing"
+          },
+          "provider": {
+            "type": "string",
+            "description": "Provider type (default: 'custom' for agent webhooks)",
+            "default": "custom"
+          },
+          "secret_key": {
+            "type": "string",
+            "description": "Secret key for HMAC signature verification. Generate a random string and use it to verify incoming webhooks."
+          },
+          "auth_type": {
+            "type": "string",
+            "enum": [
+              "hmac-sha256",
+              "bearer",
+              "basic",
+              "none"
+            ],
+            "description": "Authentication method for webhook delivery",
+            "default": "hmac-sha256"
+          },
+          "description": {
+            "type": "string",
+            "description": "Optional description of what this webhook is used for"
+          },
+          "headers": {
+            "type": "object",
+            "description": "Optional custom headers to include in webhook requests"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "description": "Timeout for webhook delivery in milliseconds (default: 30000)",
+            "default": 30000
+          },
+          "retry_config": {
+            "type": "object",
+            "description": "Retry configuration",
+            "properties": {
+              "max_attempts": {
+                "type": "integer",
+                "default": 3
+              },
+              "backoff_type": {
+                "type": "string",
+                "enum": [
+                  "exponential",
+                  "linear",
+                  "fixed"
+                ],
+                "default": "exponential"
+              }
+            }
+          }
+        },
+        "required": [
+          "name",
+          "endpoint_url",
+          "event_types",
+          "direction"
+        ]
+      }
+    },
+    {
+      "name": "omnikit_webhook_list",
+      "description": "List webhooks. Filter by direction, active status, provider, or omit filters to list all accessible webhooks.",
+      "method": "GET",
+      "path": "/webhooks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "direction": {
+            "type": "string",
+            "enum": [
+              "incoming",
+              "outgoing",
+              "all"
+            ],
+            "description": "Filter by webhook direction",
+            "default": "all"
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Filter by active status"
+          },
+          "provider": {
+            "type": "string",
+            "description": "Filter by provider (e.g., 'custom', 'stripe', 'github')"
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of webhooks to return",
+            "default": 50
+          },
+          "offset": {
+            "type": "integer",
+            "description": "Offset for pagination",
+            "default": 0
+          }
+        }
+      }
+    },
+    {
+      "name": "omnikit_webhook_get",
+      "description": "Get details of a specific webhook by ID, including configuration, status, and recent delivery stats.",
+      "method": "GET",
+      "path": "/webhooks/%7B%7Bwebhook_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "webhook_id": {
+            "type": "string",
+            "description": "Webhook ID (UUID)"
+          }
+        },
+        "required": [
+          "webhook_id"
+        ]
+      }
+    },
+    {
+      "name": "omnikit_webhook_update",
+      "description": "Update an existing webhook configuration. Change endpoint URL, event types, filters, or enable/disable.",
+      "method": "PUT",
+      "path": "/webhooks/%7B%7Bwebhook_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "webhook_id": {
+            "type": "string",
+            "description": "Webhook ID to update"
+          },
+          "name": {
+            "type": "string",
+            "description": "New name for the webhook"
+          },
+          "endpoint_url": {
+            "type": "string",
+            "description": "New endpoint URL"
+          },
+          "event_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "New list of event types to subscribe to"
+          },
+          "event_filters": {
+            "type": "object",
+            "description": "New event filters"
+          },
+          "secret_key": {
+            "type": "string",
+            "description": "New secret key for signature verification"
+          },
+          "is_active": {
+            "type": "boolean",
+            "description": "Enable or disable the webhook"
+          },
+          "headers": {
+            "type": "object",
+            "description": "Custom headers to include"
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "description": "New timeout in milliseconds"
+          }
+        },
+        "required": [
+          "webhook_id"
+        ]
+      }
+    },
+    {
+      "name": "omnikit_webhook_delete",
+      "description": "Delete a webhook subscription. You will no longer receive events at the registered endpoint.",
+      "method": "DELETE",
+      "path": "/webhooks/%7B%7Bwebhook_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "webhook_id": {
+            "type": "string",
+            "description": "Webhook ID to delete"
+          }
+        },
+        "required": [
+          "webhook_id"
+        ]
+      }
+    },
+    {
+      "name": "omnikit_event_types_list",
+      "description": "Get all available event types you can subscribe to for webhooks. Returns event names like 'user.created', 'email.sent', 'billing.payment_received', etc.",
+      "method": "GET",
+      "path": "/event-types",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "category": {
+            "type": "string",
+            "description": "Optional: filter by category prefix (e.g., 'user', 'email', 'billing')"
+          }
+        }
+      }
+    }
+  ]
+}