Skip to main content

Abstra Manager API

Access organization data, members, and project consumption metrics via the Abstra Manager API.

Abstra Manager API Logo

Authentication

This connector uses Token-based authentication.

info

Set up your connection in the Abstra Console before using it in your workflows.

How to use

Using the Smart Chat

Execute the action "CHOOSE_ONE_ACTION_BELOW" from my connector "YOUR_CONNECTOR_NAME" using the params "PARAMS_HERE".

Using the Web Editor

from abstra.connectors import run_connection_action

result = run_connection_action(
connection_name="your_connection_name",
action_name="your_action_name",
params={
"param1": "value1",
"param2": "value2"
})

Available Actions

This connector provides 17 actions:

ActionPurposeParameters
get_organizationGet organization structure with folders and projectsNo parameters
get_membersList organization members with their folder assignmentsNo parameters
get_project_executionsList workflow stage executions for a project within a date range max 31 days. Each execution is one run of a stage hook, form, tasklet, or job. Returns id, status, buildId, stageId, stageName and createdAt for each, plus a totalCount. Paginated newest first via limit + offset — keep paging until offset + executions.length = totalCount.projectId (string) required
from (string) required
to (string) required
limit (integer)
offset (integer)
get_project_consumptionGet consumption metrics for a project within a date range max 31 days. Returns tables rows tablesRows is the last daily snapshot in the range; tablesRowsAvg is the average over the range, files storage, email notifications, AI prompts count of AI calls, document AI count of OCR PAGES processed, not calls, agent runs, Smart Chat token usage smartChatTokens total plus smartChatTokensByUser broken down per user, tables processing rows, and CPU/RAM actual consumption over the range cpu in vCPU-hoursprojectId (string) required
from (string) required
to (string) required
metrics (array)
list_project_tablesList Abstra Tables cloud database tables for a project. Returns each table with its columns name and type. Useful to understand the data model of a project.projectId (string) required
list_project_connectorsList connector instances configured in a project. Returns each connection with its name, connector type e.g. slack, google-calendar, status, scopes and timestamps. Secrets are never included.projectId (string) required
list_project_forms_and_pagesList forms and pages of a project from the latest deployed build, distinguishing public anonymous access from private auth/roles required. For each stage returns id, title, path, isPublic and requiredRoles. Returns empty arrays if the project has never been deployed.projectId (string) required
get_project_abstra_jsonGet a project's abstra.json from two sources: deployed the abstra.json bundled in the latest successful build — what's currently serving traffic and editor the abstra.json on the web-editor's filesystem — what the user is currently editing, possibly with undeployed changes. Both are returned as parsed JSON objects forms, pages, hooks, jobs, scripts, components, transitions, workflow_position, workspace, auth… so the caller can inspect the full workflow graph. Either side may be null if the projeprojectId (string) required
get_organization_action_logsList CRUD/command audit events scoped to the organization e.g. member, folder, organization-level operations within a date range max 31 days. Project-scoped events are excluded — use get_project_action_logs for those. Returns one page at a time, newest first. Use cursor and limit to paginate. Pass the same from/to on each request; pass the response nextCursor as cursor on the next. Keep following nextCursor until it comes back null: a page can hold fewer rows than limit and still not be the lastfrom (string) required
to (string) required
event (string)
cursor (string)
limit (integer)
get_project_action_logsList CRUD/command audit events scoped to one or more projects within a date range max 31 days. For organization-level events members, folders, org settings use get_organization_action_logs instead. Up to 100 projectIds per call, split larger sets of projects into separate calls. Returns one page at a time, newest first. Use cursor and limit to paginate. Pass the same from/to/projectIds on each request; pass the response nextCursor as cursor on the next. Keep following nextCursor until it comes bprojectIds (array) required
from (string) required
to (string) required
event (string)
cursor (string)
limit (integer)
get_auth_attempt_logsList authentication attempts success and failure for the organization within a date range max 31 days. Paginated newest first. Filter by project, status, or email. Keep following nextCursor until it comes back null: a page can hold fewer rows than limit and still not be the last one, so page size never signals the end.from (string) required
to (string) required
projectId (string)
status (string)
email (string)
cursor (string)
limit (integer)
get_email_notification_logsList email notifications sent by the organization within a date range max 31 days. Paginated newest first. Filter by project or kind. Keep following nextCursor until it comes back null: a page can hold fewer rows than limit and still not be the last one, so page size never signals the end.from (string) required
to (string) required
projectId (string)
kind (string)
cursor (string)
limit (integer)
count_connector_action_logsCount connector action invocations for the organization within a date range max 31 days in a single call, instead of paging through them. Same scope and filters as get_connector_action_logs. Pass groupBy to also get the breakdown by project, source, connection or action — groups come back ordered by volume, capped at the top 20, with the tail folded into a single other group so the groups always sum to the total. Manual access by Abstra accounts through the editor or AI is excluded; calls orfrom (string) required
to (string) required
projectId (string)
source (string)
errored (boolean)
groupBy (string)
get_connector_action_logsList connector action invocations for the organization within a date range max 31 days. Paginated newest first. Filter by project, invocation source app/editor/ai/api, or error state. Keep following nextCursor until it comes back null: a page can hold fewer rows than limit and still not be the last one, so page size never signals the end. To count invocations rather than read them, use count_connector_action_logs. Manual access by Abstra accounts through the editor or AI is excluded; calls origifrom (string) required
to (string) required
projectId (string)
source (string)
errored (boolean)
cursor (string)
limit (integer)
get_ai_prompt_logsList AI prompt invocations for the organization within a date range max 31 days. Paginated newest first. Filter by project or error state. Keep following nextCursor until it comes back null: a page can hold fewer rows than limit and still not be the last one, so page size never signals the end.from (string) required
to (string) required
projectId (string)
errored (boolean)
cursor (string)
limit (integer)
add_memberAdd a member to the organization by email. Optionally assign them to specific folders.email (string) required
folderIds (array)
remove_memberRemove a member from the organization by email.email (string) required