Admin API Key Endpoints

Admin API keys (also called poweruser keys) give you full programmatic access to manage your Autessa resources — agents, tools, managers, AutessaDB tables, connectors, scheduled events, webhooks, MCP servers, and more.

Admin API key endpoints are read/write for most resources but intentionally exclude destructive or high-risk operations like delete, share, and transfer-ownership. These require human oversight via the Builder UI.

Base URL

https://api.autessa.com/autessa_poweruser

All endpoints use POST method with JSON request bodies.

Authentication

Admin API keys use a different format from client API keys. Pass your admin key in the Authorization header:

Authorization: pwrusr:{key_id}:{secret}

For temporary keys (JWT-based):

Authorization: pwrusr_temp:{jwt_token}

Generating an Admin API Key

Navigate to Settings → API Keys in the Autessa Builder
Click Generate Admin Key
Copy the key — it will only be shown once

cURL
JavaScript
Python

curl https://api.autessa.com/autessa_poweruser/agents/all \
  -H "Authorization: pwrusr:your_key_id:your_secret" \
  -H "Content-Type: application/json" \
  -d '{}'

const response = await fetch(
  'https://api.autessa.com/autessa_poweruser/agents/all',
  {
method: 'POST',
headers: {
  'Authorization': 'pwrusr:your_key_id:your_secret',
  'Content-Type': 'application/json',
},
body: JSON.stringify({}),
  }
)

import requests

response = requests.post(
'https://api.autessa.com/autessa_poweruser/agents/all',
headers={
    'Authorization': 'pwrusr:your_key_id:your_secret',
    'Content-Type': 'application/json',
},
json={},
)

Excluded Operations

The following operations are not available via admin API keys and must be performed in the Builder UI:

Delete / Confirm Delete — Deletion requires human oversight
Share — Sharing permissions requires human oversight
Transfer Ownership — Ownership changes require human oversight
Get Sharing Details — Admin-only UI operation

User POST`/autessa_poweruser/user`

Get Current User POST`/me`

Returns information about the authenticated user linked to the admin API key.

Request Body

No request body required (send empty object {}).

Response

Name
email
Type
string
Description
The user's email address.
Name
name
Type
string
Description
The user's display name.
Name
companyName
Type
string
Description
The name of the company/workspace the key is scoped to.

cURL
Response

curl https://api.autessa.com/autessa_poweruser/user/me \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "email": "user@example.com",
  "name": "Jane Doe",
  "companyName": "Acme Corp"
}

Agents POST`/autessa_poweruser/agents`

Manage AI agents — create, read, update, publish, rollback, and view conversation history.

List All Agents POST`/all`

Returns all agents accessible to the authenticated user, grouped by ownership and sharing.

Request Body

No fields required (send empty object {}).

Response

Name
ownedAgents
Type
array<AgentDto>
Description
Agents owned by the authenticated user.
Name
companySharedAgents
Type
array<AgentDto>
Description
Agents shared company-wide.
Name
sharedWithMeAgents
Type
array<AgentDto>
Description
Agents specifically shared with the user.

cURL
Response

  curl https://api.autessa.com/autessa_poweruser/agents/all \
    -H "Authorization: pwrusr:key_id:secret" \
    -H "Content-Type: application/json" \
    -d '{}'

{
"ownedAgents": [
  { "agentId": 1, "agentName": "Customer Support Bot", "agentType": "CONVERSATIONAL" }
],
"companySharedAgents": [],
"sharedWithMeAgents": []
}

Get Agent POST`/get`

Retrieves a specific agent by ID.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.
Name
version
Type
object
Description
Optional version override with versionState and versionNumber.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Create Agent POST`/create`

Creates a new agent.

Request Body

Name
agentName
Type
string
Description
Display name for the agent.
Name
agentDescription
Type
string
Description
Description of the agent's purpose.
Name
agentType
Type
string
Description
The agent type (e.g., CONVERSATIONAL).

cURL
curl https://api.autessa.com/autessa_poweruser/agents/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentName": "My Agent", "agentType": "CONVERSATIONAL" }'

Update Agent POST`/update`

Updates an existing agent's configuration.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent to update.

Additional fields depend on what you're updating (name, description, system prompt, tools, etc.).

cURL
curl https://api.autessa.com/autessa_poweruser/agents/update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123, "agentName": "Updated Name" }'

Publish Agent POST`/publish`

Publishes the current draft of an agent, making it the active version.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent to publish.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/publish \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Rollback Agent POST`/rollback`

Rolls back an agent to a previous version.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/rollback \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Get Agent Versions POST`/versions`

Returns the version history for an agent.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/versions \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Get Conversation History POST`/conversations/history`

Returns conversation history for an agent.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/conversations/history \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Submit Evaluation POST`/submit-evaluation`

Submits a human evaluation for an agent conversation.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/submit-evaluation \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Get Agent Statistics POST`/statistics`

Returns usage statistics for an agent.

Request Body

Name
agentId
Type
integer
Description
The ID of the agent.

cURL
curl https://api.autessa.com/autessa_poweruser/agents/statistics \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": 123 }'

Tools POST`/autessa_poweruser/tools`

Manage custom tools — create, read, update, publish, rollback, and create from MCP servers.

List All Tools POST`/all`

Returns all tools accessible to the authenticated user.

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/tools/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Tool POST`/get`

Retrieves a specific tool by ID.

Request Body

Name
toolId
Type
integer
Description
The ID of the tool.
Name
version
Type
object
Description
Optional version override.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolId": 456 }'

Create Tool POST`/create`

Creates a new tool.

Request Body

Name
toolName
Type
string
Description
Display name for the tool.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolName": "My Tool" }'

Update Tool POST`/update`

Updates an existing tool.

Request Body

Name
toolId
Type
integer
Description
The ID of the tool to update.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolId": 456 }'

Publish Tool POST`/publish`

Publishes the current draft of a tool.

Request Body

Name
toolId
Type
integer
Description
The ID of the tool to publish.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/publish \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolId": 456 }'

Rollback Tool POST`/rollback`

Rolls back a tool to a previous version.

Request Body

Name
toolId
Type
integer
Description
The ID of the tool.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/rollback \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolId": 456 }'

Get Tool Versions POST`/versions`

Returns the version history for a tool.

Request Body

Name
toolId
Type
integer
Description
The ID of the tool.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/versions \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "toolId": 456 }'

Create Tool from MCP POST`/create-from-mcp`

Creates a new tool from an MCP server tool definition.

Request Body

Name
mcpServerId
Type
integer
Description
The ID of the MCP server.

cURL
curl https://api.autessa.com/autessa_poweruser/tools/create-from-mcp \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "mcpServerId": 789 }'

Managers POST`/autessa_poweruser/managers`

Manage multi-agent managers — create, read, update, publish, rollback, and view conversations.

List All Managers POST`/get-all`

Returns all managers accessible to the authenticated user.

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/managers/get-all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Manager POST`/get`

Request Body

Name
managerId
Type
integer
Description
The ID of the manager.

cURL
curl https://api.autessa.com/autessa_poweruser/managers/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "managerId": 123 }'

Create Manager POST`/create`

Request Body

Name
managerName
Type
string
Description
Display name for the manager.

cURL
curl https://api.autessa.com/autessa_poweruser/managers/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "managerName": "My Manager" }'

Update / Publish / Rollback / Versions

These follow the same pattern as Agents — pass managerId in the request body.

Endpoint	Description
`/update`	Update a manager's configuration
`/publish`	Publish the current draft
`/rollback`	Rollback to a previous version
`/versions`	Get version history

Get Manager Conversations POST`/conversations`

Returns conversation list for a manager.

Request Body

Name
managerId
Type
integer
Description
The ID of the manager.

cURL
curl https://api.autessa.com/autessa_poweruser/managers/conversations \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "managerId": 123 }'

Get Single Conversation POST`/conversation`

Returns a specific conversation's details.

Request Body

Name
managerId
Type
integer
Description
The ID of the manager.

cURL
curl https://api.autessa.com/autessa_poweruser/managers/conversation \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "managerId": 123 }'

Get Manager Statistics POST`/statistics`

Returns usage statistics for a manager.

Request Body

Name
managerId
Type
integer
Description
The ID of the manager.

cURL
curl https://api.autessa.com/autessa_poweruser/managers/statistics \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "managerId": 123 }'

AutessaDB Tables POST`/autessa_poweruser/autessadb/tables`

Manage database tables — create, read, update schema, and manage knowledge bases.

List All Tables POST`/all`

Returns all tables accessible to the authenticated user.

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Table POST`/get`

Request Body

Name
tableId
Type
integer
Description
The ID of the table.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Get Table Options POST`/table-options`

Returns available table configuration options (column types, etc.).

Request Body

No fields required.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/table-options \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Create Table POST`/create`

Creates a new AutessaDB table.

Request Body

Name
tableName
Type
string
Description
Name for the new table.
Name
columns
Type
array
Description
Column definitions for the table schema.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableName": "customers", "columns": [...] }'

Create Knowledge Base POST`/create-knowledge-base`

Creates a new knowledge base table optimized for semantic search.

Request Body

Name
tableName
Type
string
Description
Name for the knowledge base.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/create-knowledge-base \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableName": "docs_kb" }'

Generate Knowledge Base Upload Links POST`/generate-knowledge-base-upload-links`

Generates presigned upload URLs for knowledge base file ingestion.

Request Body

Name
tableId
Type
integer
Description
The ID of the knowledge base table.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/generate-knowledge-base-upload-links \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Update Table Schema POST`/update-schema`

Updates the schema of an existing table.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/tables/update-schema \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

AutessaDB Queries POST`/autessa_poweruser/autessadb/query`

Perform data operations on AutessaDB tables — insert, update, delete, query, search, and join.

Insert Row POST`/insert`

Inserts a new row into a table.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
data
Type
object
Description
Key-value pairs of column names to values.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/insert \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "data": { "name": "Alice", "email": "alice@example.com" } }'

Update Row POST`/update`

Updates an existing row.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rowId
Type
integer
Description
The ID of the row to update.
Name
data
Type
object
Description
Key-value pairs of columns to update.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rowId": 1, "data": { "name": "Alice Updated" } }'

Batch Update Rows POST`/batch-update`

Updates multiple rows in a single request.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rows
Type
array
Description
Array of row updates, each with rowId and data.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/batch-update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rows": [{ "rowId": 1, "data": { "name": "A" } }, { "rowId": 2, "data": { "name": "B" } }] }'

Delete Row POST`/delete-row`

Deletes a single row from a table.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rowId
Type
integer
Description
The ID of the row to delete.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/delete-row \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rowId": 1 }'

Batch Delete Rows POST`/batch-delete`

Deletes multiple rows in a single request.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rowIds
Type
array<integer>
Description
Array of row IDs to delete.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/batch-delete \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rowIds": [1, 2, 3] }'

Get Table Data POST`/get-data`

Returns paginated table data.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/get-data \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Get Single Row POST`/get-single-row`

Returns a single row by ID.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rowId
Type
integer
Description
The ID of the row.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/get-single-row \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rowId": 1 }'

Query Table Data POST`/query`

Queries table data with filters and conditions.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
filters
Type
array
Description
Array of filter conditions.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/query \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Join Query POST`/join-query`

Performs a join query across multiple tables.

Request Body

Name
tableId
Type
integer
Description
The primary table ID.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/join-query \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Semantic Search POST`/search`

Performs semantic vector search on a table's indexed columns.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
query
Type
string
Description
The search query text.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/search \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "query": "customer complaints about billing" }'

Generate Upload Link POST`/generate-upload-link`

Generates a presigned S3 upload URL for file columns.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/generate-upload-link \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789 }'

Index Record Row POST`/index-record`

Triggers vector indexing for a specific row.

Request Body

Name
tableId
Type
integer
Description
The ID of the table.
Name
rowId
Type
integer
Description
The ID of the row to index.

cURL
curl https://api.autessa.com/autessa_poweruser/autessadb/query/index-record \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "tableId": 789, "rowId": 1 }'

Connectors POST`/autessa_poweruser/connectors`

Read-only access to all external connectors (Gmail, Box, HubSpot, Acumatica, etc.) via a single centralized endpoint. The connector type is specified in the request body.

Supported Connector Types

GMAIL, GOOGLE_CALENDAR, GOOGLE_ANALYTICS, BOX, LINKEDIN, TWITTER, FACEBOOK, INSTAGRAM, REDDIT, THREADS, ZENDESK, YOUTUBE, TIKTOK, ACUMATICA, HUBSPOT, ZOHO_CRM, OUTLOOK, MAILCHIMP, GHOST, BEEHIIV, BLUESKY, QUICKBOOKS

List All Connectors POST`/all`

Returns all active connectors of the specified type accessible to the authenticated user.

Request Body

Name
connectorType
Type
string
Description
The connector type enum value (e.g., GMAIL, HUBSPOT, ACUMATICA).

Response

Returns a list of connector DTOs with fields specific to the connector type (e.g., account email for Gmail, host URL for Acumatica), plus common fields: connectorId, connectorName, isActive, sharingLevel, userAccessLevel, createdAt, updatedAt.

cURL — Gmail
cURL — HubSpot
Response

curl https://api.autessa.com/autessa_poweruser/connectors/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "connectorType": "GMAIL" }'

curl https://api.autessa.com/autessa_poweruser/connectors/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "connectorType": "HUBSPOT" }'

{
  "connectors": [
{
  "connectorId": 1,
  "connectorName": "Work Gmail",
  "isActive": true,
  "sharingLevel": "COMPANY",
  "userAccessLevel": "ADMIN"
}
  ]
}

Get Connector POST`/get`

Retrieves a specific connector by type and ID.

Request Body

Name
connectorType
Type
string
Description
The connector type enum value.
Name
connectorId
Type
integer
Description
The ID of the connector.

cURL
Response

curl https://api.autessa.com/autessa_poweruser/connectors/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "connectorType": "ACUMATICA", "connectorId": 42 }'

{
  "connector": {
"connectorId": 42,
"connectorName": "Acumatica Production",
"hostUrl": "https://acumatica.example.com",
"accountEmail": "api@example.com",
"isActive": true,
"userAccessLevel": "ADMIN"
  }
}

Scheduled Events POST`/autessa_poweruser/scheduled-events`

Create and manage automated recurring or one-time events.

List All Events POST`/all`

Returns all scheduled events accessible to the authenticated user.

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Event POST`/get`

Request Body

Name
scheduledEventId
Type
integer
Description
The ID of the scheduled event.

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "scheduledEventId": 123 }'

Create Event POST`/create`

Creates a new scheduled event.

Request Body

Name
eventName
Type
string
Description
Display name for the event.
Name
scheduleExpression
Type
string
Description
Schedule expression: cron(...), rate(...), or at(...).

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "eventName": "Daily Report", "scheduleExpression": "rate(1 day)" }'

Update Event POST`/update`

Request Body

Name
scheduledEventId
Type
integer
Description
The ID of the event to update.

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "scheduledEventId": 123 }'

Toggle Event POST`/toggle`

Enables or disables a scheduled event.

Request Body

Name
scheduledEventId
Type
integer
Description
The ID of the event.

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/toggle \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "scheduledEventId": 123 }'

Get Event History POST`/history`

Returns execution history for a scheduled event.

Request Body

Name
scheduledEventId
Type
integer
Description
The ID of the event.

cURL
curl https://api.autessa.com/autessa_poweruser/scheduled-events/history \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "scheduledEventId": 123 }'

Custom Webhooks POST`/autessa_poweruser/custom-webhooks`

Create and manage custom webhook endpoints that trigger agent or tool executions.

List All Webhooks POST`/get-all`

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/custom-webhooks/get-all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Webhook POST`/get`

Request Body

Name
webhookId
Type
integer
Description
The ID of the webhook.

cURL
curl https://api.autessa.com/autessa_poweruser/custom-webhooks/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "webhookId": 123 }'

Create Webhook POST`/create`

Request Body

Name
webhookName
Type
string
Description
Display name for the webhook.

cURL
curl https://api.autessa.com/autessa_poweruser/custom-webhooks/create \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "webhookName": "Stripe Events" }'

Update Webhook POST`/update`

Request Body

Name
webhookId
Type
integer
Description
The ID of the webhook to update.

cURL
curl https://api.autessa.com/autessa_poweruser/custom-webhooks/update \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "webhookId": 123 }'

Get Execution History POST`/get-execution-history`

Returns execution history for a webhook.

Request Body

Name
webhookId
Type
integer
Description
The ID of the webhook.

cURL
curl https://api.autessa.com/autessa_poweruser/custom-webhooks/get-execution-history \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "webhookId": 123 }'

MCP Servers POST`/autessa_poweruser/mcp/servers`

Read-only access to MCP (Model Context Protocol) server configurations.

MCP server endpoints are read-only via admin API keys. Creating, updating, and deleting servers requires the Builder UI.

List All MCP Servers POST`/all`

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/mcp/servers/all \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get MCP Server POST`/get`

Request Body

Name
serverId
Type
integer
Description
The ID of the MCP server.

cURL
curl https://api.autessa.com/autessa_poweruser/mcp/servers/get \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "serverId": 123 }'

Twilio Phone POST`/autessa_poweruser/twilio`

Manage Twilio phone numbers and voice routing for phone-based agents.

Purchase Phone Number POST`/purchase-number`

Purchases a new Twilio phone number.

Request Body

Refer to Twilio integration documentation for required fields.

cURL
curl https://api.autessa.com/autessa_poweruser/twilio/purchase-number \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Configure Routing POST`/configure-routing`

Configures call routing for a phone number to an agent.

Request Body

Name
phoneNumberId
Type
integer
Description
The ID of the phone number configuration.

cURL
curl https://api.autessa.com/autessa_poweruser/twilio/configure-routing \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumberId": 123 }'

Get All Phone Configs POST`/get-all-configs`

Returns all phone number configurations.

Request Body

No fields required (send empty object {}).

cURL
curl https://api.autessa.com/autessa_poweruser/twilio/get-all-configs \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Phone Config POST`/get-config`

Request Body

Name
phoneNumberId
Type
integer
Description
The ID of the phone number configuration.

cURL
curl https://api.autessa.com/autessa_poweruser/twilio/get-config \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumberId": 123 }'

Manage SMS consent records for compliance. All operations are scoped to the admin API key's linked company.

Creates a new SMS consent record.

Request Body

Name
phoneNumber
Type
string
Description
The phone number to record consent for.

cURL
curl https://api.autessa.com/autessa_poweruser/sms-consent \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": "+15551234567" }'

Searches for consent status by phone number.

Request Body

Name
phoneNumber
Type
string
Description
The phone number to search for.

cURL
curl https://api.autessa.com/autessa_poweruser/sms-consent/search \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{ "phoneNumber": "+15551234567" }'

Generate Upload Link POST`/generate-upload-link`

Generates a presigned URL for uploading consent evidence files.

Request Body

Refer to SMS consent documentation for required fields.

cURL
curl https://api.autessa.com/autessa_poweruser/sms-consent/generate-upload-link \
  -H "Authorization: pwrusr:key_id:secret" \
  -H "Content-Type: application/json" \
  -d '{}'

Endpoint Summary

Resource	Base Path	Endpoints
User	`/autessa_poweruser/user`	`/me`
Agents	`/autessa_poweruser/agents`	`/all`, `/get`, `/create`, `/update`, `/publish`, `/rollback`, `/versions`, `/conversations/history`, `/submit-evaluation`, `/statistics`
Tools	`/autessa_poweruser/tools`	`/all`, `/get`, `/create`, `/update`, `/publish`, `/rollback`, `/versions`, `/create-from-mcp`
Managers	`/autessa_poweruser/managers`	`/get-all`, `/get`, `/create`, `/update`, `/publish`, `/rollback`, `/versions`, `/conversations`, `/conversation`, `/statistics`
AutessaDB Tables	`/autessa_poweruser/autessadb/tables`	`/all`, `/get`, `/table-options`, `/create`, `/create-knowledge-base`, `/generate-knowledge-base-upload-links`, `/update-schema`
AutessaDB Queries	`/autessa_poweruser/autessadb/query`	`/insert`, `/update`, `/batch-update`, `/delete-row`, `/batch-delete`, `/get-data`, `/get-single-row`, `/query`, `/join-query`, `/search`, `/generate-upload-link`, `/index-record`
Connectors	`/autessa_poweruser/connectors`	`/all`, `/get`
Scheduled Events	`/autessa_poweruser/scheduled-events`	`/all`, `/get`, `/create`, `/update`, `/toggle`, `/history`
Custom Webhooks	`/autessa_poweruser/custom-webhooks`	`/get-all`, `/get`, `/create`, `/update`, `/get-execution-history`
MCP Servers	`/autessa_poweruser/mcp/servers`	`/all`, `/get`
Twilio Phone	`/autessa_poweruser/twilio`	`/purchase-number`, `/configure-routing`, `/get-all-configs`, `/get-config`
SMS Consent	`/autessa_poweruser/sms-consent`	`/`, `/search`, `/generate-upload-link`

Base URL​

Authentication​

Generating an Admin API Key​

Excluded Operations​

User POST/autessa_poweruser/user​

Get Current User POST/me​

Request Body​

Response​

Agents POST/autessa_poweruser/agents​

List All Agents POST/all​

Request Body​

Response​

Get Agent POST/get​

Request Body​

Create Agent POST/create​

Request Body​

Update Agent POST/update​

Request Body​

Publish Agent POST/publish​

Request Body​

Rollback Agent POST/rollback​

Request Body​

Get Agent Versions POST/versions​

Request Body​

Get Conversation History POST/conversations/history​

Request Body​

Submit Evaluation POST/submit-evaluation​

Request Body​

Get Agent Statistics POST/statistics​

Request Body​

Tools POST/autessa_poweruser/tools​

List All Tools POST/all​

Request Body​

Get Tool POST/get​

Request Body​

Create Tool POST/create​

Request Body​

Update Tool POST/update​

Request Body​

Publish Tool POST/publish​

Request Body​

Rollback Tool POST/rollback​

Request Body​

Get Tool Versions POST/versions​

Request Body​

Create Tool from MCP POST/create-from-mcp​

Request Body​

Managers POST/autessa_poweruser/managers​

List All Managers POST/get-all​

Request Body​

Get Manager POST/get​

Request Body​

Create Manager POST/create​

Request Body​

Update / Publish / Rollback / Versions​

Get Manager Conversations POST/conversations​

Request Body​

Get Single Conversation POST/conversation​

Request Body​

Get Manager Statistics POST/statistics​

Request Body​

AutessaDB Tables POST/autessa_poweruser/autessadb/tables​

List All Tables POST/all​

Request Body​

Get Table POST/get​

Request Body​

Get Table Options POST/table-options​

Request Body​

Create Table POST/create​

Request Body​

Create Knowledge Base POST/create-knowledge-base​

Request Body​

Generate Knowledge Base Upload Links POST/generate-knowledge-base-upload-links​

Request Body​

Update Table Schema POST/update-schema​

Request Body​

AutessaDB Queries POST/autessa_poweruser/autessadb/query​

Insert Row POST/insert​

Request Body​

Update Row POST/update​

Base URL

Authentication

Generating an Admin API Key

Excluded Operations

User POST`/autessa_poweruser/user`

Get Current User POST`/me`

Request Body

Response

Agents POST`/autessa_poweruser/agents`

List All Agents POST`/all`

Request Body

Response

Get Agent POST`/get`

Request Body

Create Agent POST`/create`

Request Body

Update Agent POST`/update`

Request Body

Publish Agent POST`/publish`

Request Body

Rollback Agent POST`/rollback`

Request Body

Get Agent Versions POST`/versions`

Request Body

Get Conversation History POST`/conversations/history`

Request Body

Submit Evaluation POST`/submit-evaluation`

Request Body

Get Agent Statistics POST`/statistics`

Request Body

Tools POST`/autessa_poweruser/tools`

List All Tools POST`/all`

Request Body

Get Tool POST`/get`

Request Body

Create Tool POST`/create`

Request Body

Update Tool POST`/update`

Request Body

Publish Tool POST`/publish`

Request Body

Rollback Tool POST`/rollback`

Request Body

Get Tool Versions POST`/versions`

Request Body

Create Tool from MCP POST`/create-from-mcp`

Request Body

Managers POST`/autessa_poweruser/managers`

List All Managers POST`/get-all`

Request Body

Get Manager POST`/get`

Request Body

Create Manager POST`/create`

Request Body

Update / Publish / Rollback / Versions

Get Manager Conversations POST`/conversations`

Request Body

Get Single Conversation POST`/conversation`

Request Body

Get Manager Statistics POST`/statistics`

Request Body

AutessaDB Tables POST`/autessa_poweruser/autessadb/tables`

List All Tables POST`/all`

Request Body

Get Table POST`/get`

Request Body

Get Table Options POST`/table-options`

Request Body

Create Table POST`/create`

Request Body

Create Knowledge Base POST`/create-knowledge-base`

Request Body

Generate Knowledge Base Upload Links POST`/generate-knowledge-base-upload-links`

Request Body

Update Table Schema POST`/update-schema`

Request Body

AutessaDB Queries POST`/autessa_poweruser/autessadb/query`

Insert Row POST`/insert`

Request Body

Update Row POST`/update`