# apowerb

> Open-source agentic framework — orchestration, tools, RAG, Text-to-SQL and webhooks on top of FastAPI and Google ADK.

## Docs

- [Create Session](https://docs.apowerb.com/api-reference/adk/create-session.md): Endpoint to create an ADK agent session.
- [Delete Session](https://docs.apowerb.com/api-reference/adk/delete-session.md): Endpoint to delete an ADK agent session.
- [Generate Title Endpoint](https://docs.apowerb.com/api-reference/adk/generate-title-endpoint.md): Génère un titre court de conversation à partir de son premier message.
- [Get Session History](https://docs.apowerb.com/api-reference/adk/get-session-history.md): Retrieve message history from an ADK session.
- [Get Session Trace](https://docs.apowerb.com/api-reference/adk/get-session-trace.md): Retrieve a structured trace of an ADK session for supervision.
- [List All Sessions](https://docs.apowerb.com/api-reference/adk/list-all-sessions.md): List all ADK sessions across all agents for the current user.
- [Run Agent](https://docs.apowerb.com/api-reference/adk/run-agent.md): Endpoint to run an ADK agent with comprehensive error handling.
- [Run Agent From Jwt Endpoint](https://docs.apowerb.com/api-reference/adk/run-agent-from-jwt-endpoint.md): Execute an agent using JWT token (called by Mage AI). Automatically rotates the token in the trigger after each successful run so the jwt_token stored in Mage never expires (self-healing schedule).
- [Run Agent From Refresh Token Endpoint](https://docs.apowerb.com/api-reference/adk/run-agent-from-refresh-token-endpoint.md): Execute agent using refresh token with TOKEN ROTATION.
- [Run Agent Now Endpoint](https://docs.apowerb.com/api-reference/adk/run-agent-now-endpoint.md): Trigger an immediate Mage pipeline run for an agent.
- [Run Agent Sse](https://docs.apowerb.com/api-reference/adk/run-agent-sse.md): Endpoint to run an ADK agent with SSE streaming.
- [Schedule Agent Run Endpoint](https://docs.apowerb.com/api-reference/adk/schedule-agent-run-endpoint.md): Schedule an agent to run via Mage AI.
- [Update Session](https://docs.apowerb.com/api-reference/adk/update-session.md): Endpoint to update an ADK agent session.
- [Create Agent](https://docs.apowerb.com/api-reference/agents/create-agent.md): Endpoint to create a new agent. - No Mage triggers are created during agent creation - Triggers are lazily created when first scheduling a run via /schedule_run - This allows for flexible scheduling (cron expressions, @hourly, @daily, etc.)
- [Hot-reload an agent's module and runner](https://docs.apowerb.com/api-reference/agents/hot-reload-an-agents-module-and-runner.md): Invalidate the ADK caches for ``agent_id`` so the next run rebuilds it.
- [List Agents](https://docs.apowerb.com/api-reference/agents/list-agents.md): Endpoint to list all agents.
- [Read Agent](https://docs.apowerb.com/api-reference/agents/read-agent.md): Endpoint to get a specific agent by ID.
- [Remove Agent](https://docs.apowerb.com/api-reference/agents/remove-agent.md): Endpoint to delete an agent by ID.
- [Resync Template](https://docs.apowerb.com/api-reference/agents/resync-template.md): Overwrite the agent's hash-relevant fields with the live template.
- [Template Status](https://docs.apowerb.com/api-reference/agents/template-status.md): Compare the agent's stored template snapshot with the live template.
- [Update Agent](https://docs.apowerb.com/api-reference/agents/update-agent.md): Endpoint to update an existing agent.
- [Create Key](https://docs.apowerb.com/api-reference/api-keys/create-key.md): Save a new API key.
- [List Keys](https://docs.apowerb.com/api-reference/api-keys/list-keys.md): List saved API keys for the current user.
- [Remove Key](https://docs.apowerb.com/api-reference/api-keys/remove-key.md): Delete a saved API key.
- [Execute Artifact Endpoint](https://docs.apowerb.com/api-reference/artifacts/execute-artifact-endpoint.md): Execute an artifact in a Docker container.
- [Get Artifact](https://docs.apowerb.com/api-reference/artifacts/get-artifact.md): Get a specific artifact's content.
- [List Artifacts](https://docs.apowerb.com/api-reference/artifacts/list-artifacts.md): List all artifacts for a session.
- [Forgot Password](https://docs.apowerb.com/api-reference/auth/forgot-password.md): Kick off a password-reset email for ``body.email``.
- [Login](https://docs.apowerb.com/api-reference/auth/login.md)
- [Logout](https://docs.apowerb.com/api-reference/auth/logout.md): Clear the refresh token cookie.
- [Refresh Token](https://docs.apowerb.com/api-reference/auth/refresh-token.md)
- [Resend Verification](https://docs.apowerb.com/api-reference/auth/resend-verification.md): Re-send a verification email. Always 200 (no account-existence leak).
- [Reset Password](https://docs.apowerb.com/api-reference/auth/reset-password.md): Consume a reset token and rotate the user's password hash.
- [Verify Email](https://docs.apowerb.com/api-reference/auth/verify-email.md): Consume an email-verification token and mark the account verified.
- [Authentication](https://docs.apowerb.com/api-reference/authentication.md): Obtaining and using a token.
- [Delete an uploaded dataset](https://docs.apowerb.com/api-reference/bi-datasets/delete-an-uploaded-dataset.md)
- [List database tool configurations](https://docs.apowerb.com/api-reference/bi-datasets/list-database-tool-configurations.md)
- [List uploaded datasets](https://docs.apowerb.com/api-reference/bi-datasets/list-uploaded-datasets.md)
- [Preview a dataset](https://docs.apowerb.com/api-reference/bi-datasets/preview-a-dataset.md)
- [Preview a OneDrive spreadsheet (xlsx/xls/xlsm/ods/csv/tsv)](https://docs.apowerb.com/api-reference/bi-datasets/preview-a-onedrive-spreadsheet-xlsxxlsxlsmodscsvtsv.md): Download a OneDrive tabular file and return a CSV-preview-shaped response so the frontend wizard can share its rendering logic.
- [BI module statistics](https://docs.apowerb.com/api-reference/bi-stats/bi-module-statistics.md): Returns the current count of dashboards and charts.
- [Import a Google Drive file for BI analysis](https://docs.apowerb.com/api-reference/bi-upload/import-a-google-drive-file-for-bi-analysis.md)
- [List user's connected Google Drive tool configurations](https://docs.apowerb.com/api-reference/bi-upload/list-users-connected-google-drive-tool-configurations.md)
- [Upload a CSV file for BI analysis](https://docs.apowerb.com/api-reference/bi-upload/upload-a-csv-file-for-bi-analysis.md): Accepts a CSV file, validates the content, parses headers and row count, stores the file in S3, and returns metadata including the first 5 rows as a sample. Separator is auto-detected or can be set explicitly via the 'separator' form field (comma, semicolon, tab, pipe, or auto).
- [Fetch paginated data for a chart](https://docs.apowerb.com/api-reference/chart-data/fetch-paginated-data-for-a-chart.md): Resolves the chart config by ID, executes its query, applies filters and sorting, then returns a paginated raw-data response. The frontend is responsible for mapping this to an ECharts option.
- [Get chart data (public access)](https://docs.apowerb.com/api-reference/chart-data/get-chart-data-public-access.md)
- [Schedule automatic refresh of a chart via an agent](https://docs.apowerb.com/api-reference/chart-refresh/schedule-automatic-refresh-of-a-chart-via-an-agent.md): Create a cron-based schedule that triggers an agent to refresh a chart.
- [Add a chart to the user's chat dashboard (user-triggered)](https://docs.apowerb.com/api-reference/charts/add-a-chart-to-the-users-chat-dashboard-user-triggered.md): Add ``chart_id`` to the current chat's dashboard (created on first use).
- [Create a chart](https://docs.apowerb.com/api-reference/charts/create-a-chart.md)
- [Create a KPI stat card](https://docs.apowerb.com/api-reference/charts/create-a-kpi-stat-card.md)
- [Create a time-series chart](https://docs.apowerb.com/api-reference/charts/create-a-time-series-chart.md)
- [Delete a chart](https://docs.apowerb.com/api-reference/charts/delete-a-chart.md)
- [Get a single chart](https://docs.apowerb.com/api-reference/charts/get-a-single-chart.md)
- [List charts](https://docs.apowerb.com/api-reference/charts/list-charts.md): Returns a paginated list of charts. Filter by viewer role to enforce visibility.
- [Partially update a chart](https://docs.apowerb.com/api-reference/charts/partially-update-a-chart.md)
- [Get Public Config](https://docs.apowerb.com/api-reference/config/get-public-config.md): Return public configuration (no auth required).
- [Create Session](https://docs.apowerb.com/api-reference/create-session.md)
- [Create Session With Id](https://docs.apowerb.com/api-reference/create-session-with-id.md)
- [Delete a dashboard refresh schedule](https://docs.apowerb.com/api-reference/dashboard-refresh/delete-a-dashboard-refresh-schedule.md): Delete a Mage schedule trigger by ID.
- [List refresh schedules for a dashboard](https://docs.apowerb.com/api-reference/dashboard-refresh/list-refresh-schedules-for-a-dashboard.md): List all Mage schedules associated with agents for this dashboard.
- [Schedule automatic refresh of a dashboard via an agent](https://docs.apowerb.com/api-reference/dashboard-refresh/schedule-automatic-refresh-of-a-dashboard-via-an-agent.md): Create a cron-based schedule that triggers an agent to refresh a dashboard.
- [Add a component to a dashboard](https://docs.apowerb.com/api-reference/dashboards/add-a-component-to-a-dashboard.md)
- [Create a dashboard](https://docs.apowerb.com/api-reference/dashboards/create-a-dashboard.md)
- [Delete a dashboard](https://docs.apowerb.com/api-reference/dashboards/delete-a-dashboard.md)
- [Get a dashboard by ID](https://docs.apowerb.com/api-reference/dashboards/get-a-dashboard-by-id.md)
- [Get a dashboard by slug](https://docs.apowerb.com/api-reference/dashboards/get-a-dashboard-by-slug.md)
- [Get agent linked to dashboard](https://docs.apowerb.com/api-reference/dashboards/get-agent-linked-to-dashboard.md): Get the agent associated with a dashboard.
- [Get published dashboard by slug (public access)](https://docs.apowerb.com/api-reference/dashboards/get-published-dashboard-by-slug-public-access.md)
- [Link or unlink an agent to a dashboard](https://docs.apowerb.com/api-reference/dashboards/link-or-unlink-an-agent-to-a-dashboard.md): Associate an agent with a dashboard for traceability and refresh scheduling.
- [List dashboards](https://docs.apowerb.com/api-reference/dashboards/list-dashboards.md)
- [List published dashboards shared with the current user](https://docs.apowerb.com/api-reference/dashboards/list-published-dashboards-shared-with-the-current-user.md)
- [Move a component to a new grid position](https://docs.apowerb.com/api-reference/dashboards/move-a-component-to-a-new-grid-position.md)
- [Partially update a dashboard](https://docs.apowerb.com/api-reference/dashboards/partially-update-a-dashboard.md)
- [Publish a dashboard](https://docs.apowerb.com/api-reference/dashboards/publish-a-dashboard.md)
- [Remove a component from a dashboard](https://docs.apowerb.com/api-reference/dashboards/remove-a-component-from-a-dashboard.md)
- [Unpublish a dashboard](https://docs.apowerb.com/api-reference/dashboards/unpublish-a-dashboard.md)
- [Update a key-value component's content](https://docs.apowerb.com/api-reference/dashboards/update-a-key-value-components-content.md)
- [List Pins](https://docs.apowerb.com/api-reference/data-lake/list-pins.md): List all pins available in a storage board.
- [Read Pin](https://docs.apowerb.com/api-reference/data-lake/read-pin.md): Read a specific pin from the storage board.
- [Write Pin](https://docs.apowerb.com/api-reference/data-lake/write-pin.md): Write data to a pin in the storage board.
- [Get App Graph Dot](https://docs.apowerb.com/api-reference/debug/get-app-graph-dot.md): Returns the base agent graph in DOT format without any highlights.
- [Get Event Graph](https://docs.apowerb.com/api-reference/debug/get-event-graph.md)
- [Get Session Trace](https://docs.apowerb.com/api-reference/debug/get-session-trace.md)
- [Get Trace Dict](https://docs.apowerb.com/api-reference/debug/get-trace-dict.md)
- [Delete Artifact](https://docs.apowerb.com/api-reference/delete-artifact.md)
- [Delete Session](https://docs.apowerb.com/api-reference/delete-session.md)
- [Connection Status](https://docs.apowerb.com/api-reference/emailing/connection-status.md): Check whether the current user has an active Outlook Mail connection.
- [Get Auth Url](https://docs.apowerb.com/api-reference/emailing/get-auth-url.md): Generate the Microsoft OAuth consent URL for Outlook Mail access.
- [Oauth Callback](https://docs.apowerb.com/api-reference/emailing/oauth-callback.md): Exchange the authorization code for tokens and persist as tool_config.
- [Errors](https://docs.apowerb.com/api-reference/errors.md): Status codes and what they mean here.
- [Add Session To Eval Set](https://docs.apowerb.com/api-reference/evaluation/add-session-to-eval-set.md)
- [Add Session To Eval Set](https://docs.apowerb.com/api-reference/evaluation/add-session-to-eval-set-1.md)
- [Create Eval Set](https://docs.apowerb.com/api-reference/evaluation/create-eval-set.md)
- [Create Eval Set Legacy](https://docs.apowerb.com/api-reference/evaluation/create-eval-set-legacy.md): Creates an eval set, given the id.
- [Delete Eval](https://docs.apowerb.com/api-reference/evaluation/delete-eval.md)
- [Delete Eval](https://docs.apowerb.com/api-reference/evaluation/delete-eval-1.md)
- [Get Eval](https://docs.apowerb.com/api-reference/evaluation/get-eval.md): Gets an eval case in an eval set.
- [Get Eval](https://docs.apowerb.com/api-reference/evaluation/get-eval-1.md): Gets an eval case in an eval set.
- [Get Eval Result](https://docs.apowerb.com/api-reference/evaluation/get-eval-result.md): Gets the eval result for the given eval id.
- [Get Eval Result Legacy](https://docs.apowerb.com/api-reference/evaluation/get-eval-result-legacy.md)
- [List Eval Results](https://docs.apowerb.com/api-reference/evaluation/list-eval-results.md): Lists all eval results for the given app.
- [List Eval Results Legacy](https://docs.apowerb.com/api-reference/evaluation/list-eval-results-legacy.md)
- [List Eval Sets](https://docs.apowerb.com/api-reference/evaluation/list-eval-sets.md): Lists all eval sets for the given app.
- [List Eval Sets Legacy](https://docs.apowerb.com/api-reference/evaluation/list-eval-sets-legacy.md)
- [List Evals In Eval Set](https://docs.apowerb.com/api-reference/evaluation/list-evals-in-eval-set.md): Lists all evals in an eval set.
- [List Metrics Info](https://docs.apowerb.com/api-reference/evaluation/list-metrics-info.md): Lists all eval metrics for the given app.
- [Run Eval](https://docs.apowerb.com/api-reference/evaluation/run-eval.md): Runs an eval given the details in the eval request.
- [Run Eval Legacy](https://docs.apowerb.com/api-reference/evaluation/run-eval-legacy.md)
- [Update Eval](https://docs.apowerb.com/api-reference/evaluation/update-eval.md)
- [Update Eval](https://docs.apowerb.com/api-reference/evaluation/update-eval-1.md)
- [Download File](https://docs.apowerb.com/api-reference/files/download-file.md): Download a file. Requires either Bearer auth + agent ownership, or a scoped download token bound to this `agent_id`/`filename`.
- [List Files](https://docs.apowerb.com/api-reference/files/list-files.md): List all uploaded files for an agent.
- [Upload Chunk](https://docs.apowerb.com/api-reference/files/upload-chunk.md): Upload a single chunk of a large file.
- [Upload Complete](https://docs.apowerb.com/api-reference/files/upload-complete.md): Assemble all uploaded chunks into the final file.
- [Upload File](https://docs.apowerb.com/api-reference/files/upload-file.md): Upload a file for an agent to access.
- [Get Adk App Info](https://docs.apowerb.com/api-reference/get-adk-app-info.md): Returns the detailed info for a given ADK app.
- [Get Agent Status](https://docs.apowerb.com/api-reference/get-agent-status.md): Get the run status of an agent.
- [Get Artifact Version Metadata](https://docs.apowerb.com/api-reference/get-artifact-version-metadata.md)
- [Get Models](https://docs.apowerb.com/api-reference/get-models.md)
- [Get Session](https://docs.apowerb.com/api-reference/get-session.md)
- [Get File Content](https://docs.apowerb.com/api-reference/google-drive-browser/get-file-content.md): Fetch a Google Drive file by ID and return its contents as a base64 data-URI so the browser can construct a File object.
- [List Files](https://docs.apowerb.com/api-reference/google-drive-browser/list-files.md): Return files in a Google Drive folder (root by default).
- [Search Files](https://docs.apowerb.com/api-reference/google-drive-browser/search-files.md): Search for files across Google Drive by keyword.
- [Google Verification](https://docs.apowerb.com/api-reference/google-verification.md)
- [Health Legacy Alias](https://docs.apowerb.com/api-reference/health-legacy-alias.md): Backward-compatible alias for the old ``/health`` endpoint.
- [Liveness](https://docs.apowerb.com/api-reference/health/liveness.md)
- [Notifier Health Endpoint](https://docs.apowerb.com/api-reference/health/notifier-health-endpoint.md): Owner-integration health for the system mailer. 503 when the shared mailbox owner integration is missing/revoked (system emails would fail).
- [Readiness](https://docs.apowerb.com/api-reference/health/readiness.md)
- [Clone](https://docs.apowerb.com/api-reference/hub/clone.md): Clone an agent from the Hub into your own agent store.
- [Get Hub](https://docs.apowerb.com/api-reference/hub/get-hub.md): Get a specific hub agent by ID.
- [List Hub](https://docs.apowerb.com/api-reference/hub/list-hub.md): List all agents published in the Hub.
- [Publish](https://docs.apowerb.com/api-reference/hub/publish.md): Publish an agent to the Hub.
- [Remove From Hub](https://docs.apowerb.com/api-reference/hub/remove-from-hub.md): Remove an agent from the Hub (publisher only).
- [Add Shared Mailbox](https://docs.apowerb.com/api-reference/integrations/add-shared-mailbox.md)
- [Debug Outlook Token Scopes](https://docs.apowerb.com/api-reference/integrations/debug-outlook-token-scopes.md): Decode the stored access token and return its scopes (debug).
- [Disconnect Integration](https://docs.apowerb.com/api-reference/integrations/disconnect-integration.md): Disconnect (delete) a specific integration for the authenticated user.
- [Github Callback](https://docs.apowerb.com/api-reference/integrations/github-callback.md): Complete the GitHub OAuth flow.
- [Github Connect](https://docs.apowerb.com/api-reference/integrations/github-connect.md): Generate the GitHub OAuth authorisation URL for the authenticated user.
- [Google Callback](https://docs.apowerb.com/api-reference/integrations/google-callback.md): Complete the Google OAuth flow for a specific Google service.
- [Google Connect](https://docs.apowerb.com/api-reference/integrations/google-connect.md): Generate the Google OAuth authorisation URL for a specific Google service.
- [List Integrations](https://docs.apowerb.com/api-reference/integrations/list-integrations.md): Return all active integrations for the authenticated user (tokens excluded).
- [List Shared Mailboxes](https://docs.apowerb.com/api-reference/integrations/list-shared-mailboxes.md): Return the shared mailboxes currently configured for this user.
- [Microsoft Service Callback](https://docs.apowerb.com/api-reference/integrations/microsoft-service-callback.md): Complete the Microsoft OAuth flow for a specific service.
- [Microsoft Service Connect](https://docs.apowerb.com/api-reference/integrations/microsoft-service-connect.md): Generate the Microsoft OAuth authorisation URL for a specific service.
- [Odoo Connect](https://docs.apowerb.com/api-reference/integrations/odoo-connect.md): Authenticate against the user-provided Odoo instance and persist the credentials (api_key is encrypted at rest).
- [Remove Shared Mailbox](https://docs.apowerb.com/api-reference/integrations/remove-shared-mailbox.md)
- [Set Active Shared Mailbox](https://docs.apowerb.com/api-reference/integrations/set-active-shared-mailbox.md): Mark one of the configured shared mailboxes as the active default.
- [Suggest Shared Mailboxes](https://docs.apowerb.com/api-reference/integrations/suggest-shared-mailboxes.md): Best-effort discovery of shared mailboxes via /me/memberOf.
- [API reference](https://docs.apowerb.com/api-reference/introduction.md): How to read this reference, and where the schema comes from.
- [List Apps](https://docs.apowerb.com/api-reference/list-apps.md)
- [List Artifact Names](https://docs.apowerb.com/api-reference/list-artifact-names.md)
- [List Artifact Versions](https://docs.apowerb.com/api-reference/list-artifact-versions.md)
- [List Artifact Versions Metadata](https://docs.apowerb.com/api-reference/list-artifact-versions-metadata.md)
- [List Sessions](https://docs.apowerb.com/api-reference/list-sessions.md)
- [Load Artifact](https://docs.apowerb.com/api-reference/load-artifact.md)
- [Load Artifact Version](https://docs.apowerb.com/api-reference/load-artifact-version.md)
- [List Notifications](https://docs.apowerb.com/api-reference/notifications/list-notifications.md): Return the current user's notifications, most recent first.
- [Mark All As Read](https://docs.apowerb.com/api-reference/notifications/mark-all-as-read.md): Mark all of the current user's notifications as read.
- [Mark As Read](https://docs.apowerb.com/api-reference/notifications/mark-as-read.md): Mark a single notification as read.
- [Notification Stream](https://docs.apowerb.com/api-reference/notifications/notification-stream.md): Server-Sent Events stream that pushes notifications in real time.
- [Unread Count](https://docs.apowerb.com/api-reference/notifications/unread-count.md): Return the number of unread notifications for badge display.
- [Get Excel Preview](https://docs.apowerb.com/api-reference/onedrive-browser/get-excel-preview.md): Download a OneDrive Excel/CSV file and return its column names plus the first ``limit`` rows.
- [Get File Content](https://docs.apowerb.com/api-reference/onedrive-browser/get-file-content.md): Fetch a OneDrive file by item ID and return its contents as a base64 data-URI so the browser can construct a File object without exposing the pre-authenticated download URL.
- [List Files](https://docs.apowerb.com/api-reference/onedrive-browser/list-files.md): Return files/folders in a OneDrive directory (root by default).
- [Search Files](https://docs.apowerb.com/api-reference/onedrive-browser/search-files.md): Search for files across the drive by keyword.
- [Patch Memory](https://docs.apowerb.com/api-reference/patch-memory.md): Adds all events from a given session to the memory service.
- [Get Knowledge Map](https://docs.apowerb.com/api-reference/rag/get-knowledge-map.md): Read the knowledge map for an agent (or session), refreshing statuses of pending sources.
- [Get Status](https://docs.apowerb.com/api-reference/rag/get-status.md): Get the processing status of a specific knowledge base.
- [Index Db](https://docs.apowerb.com/api-reference/rag/index-db.md): Execute a SQL query and index the results into a RAG knowledge base.
- [Index Db Nl](https://docs.apowerb.com/api-reference/rag/index-db-nl.md): Explore a DB schema, generate SQL from natural language, and index results into RAG.
- [Index Files](https://docs.apowerb.com/api-reference/rag/index-files.md): Upload and index one or more files into a RAG knowledge base.
- [Index S3](https://docs.apowerb.com/api-reference/rag/index-s3.md): Download files from S3 and index them into a RAG knowledge base.
- [Index Url](https://docs.apowerb.com/api-reference/rag/index-url.md): Download a URL and index its content into a RAG knowledge base.
- [Rag Stream](https://docs.apowerb.com/api-reference/rag/rag-stream.md): SSE endpoint streaming RAG indexation progress for an agent's sources.
- [Rag Webhook](https://docs.apowerb.com/api-reference/rag/rag-webhook.md): Receive indexation status updates from th2llm via webhook.
- [Run Adk Agent](https://docs.apowerb.com/api-reference/run-adk-agent.md): Start running an agent in the background.
- [Run Agent](https://docs.apowerb.com/api-reference/run-agent.md)
- [Run Agent Sse](https://docs.apowerb.com/api-reference/run-agent-sse.md)
- [Save Artifact](https://docs.apowerb.com/api-reference/save-artifact.md)
- [Cancel Pipeline Run](https://docs.apowerb.com/api-reference/scheduler/cancel-pipeline-run.md): Cancel a pipeline run.
- [Create Agent Trigger](https://docs.apowerb.com/api-reference/scheduler/create-agent-trigger.md): Create a Mage trigger for an existing agent. Used for agents that were created when Mage was down, or old agents that don't have triggers yet.
- [Get Pipeline Run](https://docs.apowerb.com/api-reference/scheduler/get-pipeline-run.md): Get details for a specific pipeline run.
- [Get Pipeline Run Logs](https://docs.apowerb.com/api-reference/scheduler/get-pipeline-run-logs.md): Structured, step-by-step log for a run, so the Orchestrator UI can show a run's execution narrative instead of just its status. Backed by th2etl's ``/runs/{id}/logs``; an empty list under the default Mage orchestrator.
- [List Pipeline Schedules](https://docs.apowerb.com/api-reference/scheduler/list-pipeline-schedules.md): List triggers/schedules for a pipeline, filtered to only the current user's agents.
- [List Pipelines](https://docs.apowerb.com/api-reference/scheduler/list-pipelines.md): Endpoint to list all available pipelines.
- [List Schedule Runs](https://docs.apowerb.com/api-reference/scheduler/list-schedule-runs.md): List runs for a specific schedule, after verifying it belongs to the user.
- [Update Pipeline Schedule](https://docs.apowerb.com/api-reference/scheduler/update-pipeline-schedule.md): Update a pipeline schedule (status, interval, start_time).
- [Create Share](https://docs.apowerb.com/api-reference/share/create-share.md)
- [Delete Share](https://docs.apowerb.com/api-reference/share/delete-share.md)
- [Get Share](https://docs.apowerb.com/api-reference/share/get-share.md)
- [Create Skill](https://docs.apowerb.com/api-reference/skills/create-skill.md): Create a new custom skill.
- [Delete Skill](https://docs.apowerb.com/api-reference/skills/delete-skill.md): Delete a custom skill.
- [Export Portfolio Skill](https://docs.apowerb.com/api-reference/skills/export-portfolio-skill.md): Export a built-in portfolio skill as JSON or ADK ZIP.
- [Export Skill](https://docs.apowerb.com/api-reference/skills/export-skill.md): Export a custom skill as JSON or ADK ZIP.
- [Get Portfolio Skills](https://docs.apowerb.com/api-reference/skills/get-portfolio-skills.md): List built-in portfolio skills only.
- [Get Skill](https://docs.apowerb.com/api-reference/skills/get-skill.md): Get a specific custom skill by ID.
- [Import Skill](https://docs.apowerb.com/api-reference/skills/import-skill.md): Import a skill from a JSON or ADK ZIP file.
- [List Skills](https://docs.apowerb.com/api-reference/skills/list-skills.md): List all skills (portfolio + user's custom skills).
- [Update Skill](https://docs.apowerb.com/api-reference/skills/update-skill.md): Update an existing custom skill.
- [Get Template](https://docs.apowerb.com/api-reference/superagents/get-template.md): Get a specific SuperAgent template by id.
- [List Templates](https://docs.apowerb.com/api-reference/superagents/list-templates.md): List SuperAgent templates visible to the authenticated user.
- [Get Tool Params](https://docs.apowerb.com/api-reference/tools/get-tool-params.md): Return expected configuration parameters (env vars) for a tool.
- [Get Tools Docs](https://docs.apowerb.com/api-reference/tools/get-tools-docs.md): Return documentation for all available tools.
- [List Mcp Configs](https://docs.apowerb.com/api-reference/tools/list-mcp-configs.md): List saved MCP server configurations for the current user.
- [List Tools](https://docs.apowerb.com/api-reference/tools/list-tools.md): Endpoint to list all available tools.
- [Reload Mcp Toolbox](https://docs.apowerb.com/api-reference/tools/reload-mcp-toolbox.md): Regenerate tools.dynamic.yaml from active configs and restart the toolbox.
- [Save Mcp Config](https://docs.apowerb.com/api-reference/tools/save-mcp-config.md): Save an MCP server configuration as a reusable tool_config.
- [Update Mcp Config](https://docs.apowerb.com/api-reference/tools/update-mcp-config.md): Update an existing MCP config (rebuilds tool_config_params from the payload, re-encrypts, and refreshes the toolbox if it is a DB config).
- [Create Tool Configs](https://docs.apowerb.com/api-reference/tools_config/create-tool-configs.md): Endpoint to create a new tool config.
- [Delete Tool Configs](https://docs.apowerb.com/api-reference/tools_config/delete-tool-configs.md): Endpoint to delete a tool config by ID (scoped to current user).
- [Get Tool Configs](https://docs.apowerb.com/api-reference/tools_config/get-tool-configs.md): Endpoint to get a specific tool config by ID (scoped to current user).
- [List Tool Configs](https://docs.apowerb.com/api-reference/tools_config/list-tool-configs.md): Endpoint to list all tool configs for the current user.
- [Update Tool Configs](https://docs.apowerb.com/api-reference/tools_config/update-tool-configs.md): Update a tool config's name and/or parameters (scoped to current user).
- [Transcribe Audio](https://docs.apowerb.com/api-reference/transcribe-audio.md): One-shot transcription of an uploaded audio blob via Gemini.
- [Update Session](https://docs.apowerb.com/api-reference/update-session.md): Updates session state without running the agent.
- [Create User](https://docs.apowerb.com/api-reference/users/create-user.md)
- [Delete User](https://docs.apowerb.com/api-reference/users/delete-user.md)
- [Delete User By Email](https://docs.apowerb.com/api-reference/users/delete-user-by-email.md)
- [Get All Users](https://docs.apowerb.com/api-reference/users/get-all-users.md)
- [Get Current User Route](https://docs.apowerb.com/api-reference/users/get-current-user-route.md)
- [Get User By Email](https://docs.apowerb.com/api-reference/users/get-user-by-email.md)
- [Get User By Id](https://docs.apowerb.com/api-reference/users/get-user-by-id.md)
- [Update User](https://docs.apowerb.com/api-reference/users/update-user.md): Update user profile fields.
- [Version](https://docs.apowerb.com/api-reference/version.md)
- [Create Subscription](https://docs.apowerb.com/api-reference/webhooks/create-subscription.md): Create a new webhook subscription.
- [Delete Subscription](https://docs.apowerb.com/api-reference/webhooks/delete-subscription.md): Delete a webhook subscription from both the provider and the database.
- [Get Webhook Log Attachment](https://docs.apowerb.com/api-reference/webhooks/get-webhook-log-attachment.md): Serve one attachment captured at webhook reception time.
- [Get Webhook Log Body](https://docs.apowerb.com/api-reference/webhooks/get-webhook-log-body.md): Return the captured HTML body of a webhook-driven email.
- [Get Webhook Log By Id](https://docs.apowerb.com/api-reference/webhooks/get-webhook-log-by-id.md): Return one webhook log by id, scoped to the current user.
- [List Subscriptions](https://docs.apowerb.com/api-reference/webhooks/list-subscriptions.md): Return all webhook subscriptions owned by the current user.
- [List Webhook Logs](https://docs.apowerb.com/api-reference/webhooks/list-webhook-logs.md): Return webhook execution logs for the current user.
- [Receive Notification](https://docs.apowerb.com/api-reference/webhooks/receive-notification.md): Unified webhook notification receiver.
- [Renew Subscription](https://docs.apowerb.com/api-reference/webhooks/renew-subscription.md): Renew (extend) a webhook subscription on the provider.
- [Retrigger Webhook Log](https://docs.apowerb.com/api-reference/webhooks/retrigger-webhook-log.md): Re-queue a webhook log for processing.
- [Update Subscription](https://docs.apowerb.com/api-reference/webhooks/update-subscription.md): Update a webhook subscription (agent, template, change_type).
- [Cancel Workflow](https://docs.apowerb.com/api-reference/workflows/cancel-workflow.md): Signal a live run to terminate.
- [Run Workflow Sse](https://docs.apowerb.com/api-reference/workflows/run-workflow-sse.md): Start a workflow run and stream its events back as SSE.
- [Agents](https://docs.apowerb.com/concepts/agents.md): How an agent is defined, stored and materialised.
- [Architecture](https://docs.apowerb.com/concepts/architecture.md): How the package is laid out and what happens when the server starts.
- [Editions and extensions](https://docs.apowerb.com/concepts/editions.md): How the open-source core stays complete on its own, and how commercial bricks plug into it.
- [Orchestration](https://docs.apowerb.com/concepts/orchestration.md): The four execution patterns and how sub-agents compose.
- [Sessions and runs](https://docs.apowerb.com/concepts/sessions-and-runs.md): Conversation state, blocking runs, streaming runs and traces.
- [Tools](https://docs.apowerb.com/concepts/tools.md): The tool portfolio, and the difference between a tool and a tool config.
- [Configuration](https://docs.apowerb.com/configuration.md): Every environment variable read by the apowerb server.
- [Contributing](https://docs.apowerb.com/contributing/contributing.md): How to propose a change.
- [Development setup](https://docs.apowerb.com/contributing/development.md): Running the core locally with tests and linting.
- [Release process](https://docs.apowerb.com/contributing/releases.md): How the Python package and the TypeScript SDK are published.
- [apowerb-ui](https://docs.apowerb.com/ecosystem/apowerb-ui.md): The Next.js interface for the apowerb API.
- [Overview](https://docs.apowerb.com/ecosystem/overview.md): The repositories that make up the apowerb ecosystem.
- [th2etl](https://docs.apowerb.com/ecosystem/th2etl.md): ETL and automation library.
- [th2pulse](https://docs.apowerb.com/ecosystem/th2pulse.md): OpenTelemetry collection and observability.
- [th2rag](https://docs.apowerb.com/ecosystem/th2rag.md): The retrieval-augmented generation backend.
- [Artifacts](https://docs.apowerb.com/guides/artifacts.md): Files an agent writes during a session, and running them.
- [Agent Hub](https://docs.apowerb.com/guides/hub.md): Publish an agent, let another workspace clone it.
- [Integrations](https://docs.apowerb.com/guides/integrations.md): Connect the services your agents act on.
- [RAG](https://docs.apowerb.com/guides/rag.md): Index documents, URLs, SQL results and S3 buckets into per-agent knowledge bases.
- [Scheduler](https://docs.apowerb.com/guides/scheduler.md): Run agents on a cron schedule.
- [SSE streaming](https://docs.apowerb.com/guides/streaming.md): Three server-sent event channels.
- [Text-to-SQL](https://docs.apowerb.com/guides/text-to-sql.md): Let an agent answer questions against a relational database.
- [Webhooks](https://docs.apowerb.com/guides/webhooks.md): Trigger agents from events in connected services.
- [Gmail webhooks](https://docs.apowerb.com/guides/webhooks-gmail.md): Wire Gmail push notifications through Google Pub/Sub.
- [Outlook webhooks](https://docs.apowerb.com/guides/webhooks-outlook.md): Wire Outlook push notifications through Microsoft Graph.
- [Introduction](https://docs.apowerb.com/index.md): apowerb is an open-source agentic framework for building, running and operating AI agents.
- [Installation](https://docs.apowerb.com/installation.md): Install the apowerb package from PyPI or from source and run the server.
- [Quickstart](https://docs.apowerb.com/quickstart.md): Bring the API, the interface and a database up with Docker Compose.
- [Database](https://docs.apowerb.com/self-hosting/database.md): Postgres, TLS and migrations.
- [Docker Compose](https://docs.apowerb.com/self-hosting/docker.md): The reference self-hosting stack.
- [Production notes](https://docs.apowerb.com/self-hosting/production.md): What to check before and after a deployment.
- [Secrets](https://docs.apowerb.com/self-hosting/secrets.md): What each secret protects, and what breaks if you rotate it.

## OpenAPI Specs

- [openapi](https://docs.apowerb.com/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/apowerb)
- [PyPI](https://pypi.org/project/apowerb/)