Liferay Integration for AI Agents
Connect your AI agent to 104 QA'd Liferay actions via MCP, A2A, or SDK, with agent authentication, tool-calling execution, and security built-in, plus 10 events to subscribe to.
Liferay AI Agent Actions
104 production-ready actions for your agent to do more on Liferay.
104 Actions
List Accounts - Retrieve a paginated list of B2B business accounts (companies/organizations) from Liferay. NOT for looking up individual portal users — to look up a user by email use get_user_account_by_email_address, and to search portal users use list_user_accounts.
Get Account - Retrieve an account by ID
Get Account By External Reference Code - Retrieve a business account by its external reference code (ERC), a system-assigned sync identifier — NOT the account/company name
Create Account - Create a new business account in Liferay
List Account User Accounts - List users assigned to an account
Assign User To Account - Assign an existing user to a business account by their exact email address. Both inputs must come from prior list/lookup calls — do not guess or synthesize them.
Remove User From Account - Remove a user from an account by email address. Returns 404 when the user is not currently assigned to the specified account; treat that 404 as the negative answer ("user is not a member of this account") and report it directly — do not retry with different IDs or abandon the workflow.
List Account Roles - List account-scoped roles on an account
Assign Account Role To User - Assign an account-scoped role to a user using numeric IDs (accountId, accountRoleId, userAccountId)
Update Account - Update an existing business account
Delete Account - Delete an account by ID
List Blog Postings - Retrieve a paginated list of blog postings for a site. PREFERRED tool when the user asks to "list posts", "confirm a post exists", "show all posts", or otherwise verify blog post presence on a site — do NOT use list_my_sites for this (list_my_sites only enumerates sites, not posts).
Get Blog Posting - Retrieve a single blog posting by ID
Create Blog Posting - Create a new blog posting for a site
Update Blog Posting - Update an existing blog posting
Delete Blog Posting - Delete a blog posting by ID
List Blog Posting Comments - Retrieve comments on a blog posting
Create Blog Posting Comment - Add a comment to a blog posting
Create Structured Content Comment - Add a comment to a structured content article
List Structured Content Comments - List comments on a structured content article
Create Document Comment - Add a comment to a document
Get Comment - Retrieve a comment by ID
Replace Comment - Replace a comment's contents (full replacement)
Delete Comment - Delete a comment by ID
List Comment Replies - Retrieve replies to a comment
Create Comment Reply - Reply to a comment
List Document Comments - Retrieve comments on a document
List Content Structures - Retrieve a paginated list of content structures (templates) for a site
Get Content Structure - Retrieve a content structure by ID
List Document Folders - Retrieve a paginated list of document folders for a site
Get Document Folder - Retrieve a document folder by ID
Create Document Folder - Create a new document folder in a site
Update Document Folder - Update an existing document folder
List Document Folder Subfolders - List subfolders of a document folder
List Document Folder Documents - List documents inside a document folder
Delete Document Folder - Delete a document folder by ID
List Documents - Retrieve a paginated list of documents for a site
Get Document - Retrieve a document by ID
Create Document - Upload a new document to a site
Create Document In Folder - Upload a new document to a specific folder
Update Document - Replace a document's file and optionally update metadata
Delete Document - Delete a document by ID
Get Unified Credentials - Return the authenticated Liferay identity for the current connection, mapped to the IAM unified credentials schema. Calls GET /o/headless-admin-user/v1.0/my-user-account and inlines the authenticated user record under the user field. auth_type is always "oauth" because this connector exclusively supports OAuth2 flows (authorization_code and client_credentials).
IAM Auth Test - Validate the current Liferay OAuth token and return the raw, unmapped /my-user-account JSON. Bypasses the unified IAM credentials schema — use this for debugging which Liferay identity the connection is bound to.
List Unified Groups - List Liferay user groups mapped to the IAM unified group schema. Liferay user groups are flat collaboration groups with no parent/child hierarchy.
Get Unified Group - Retrieve a single Liferay user group by id, mapped to the IAM unified group schema.
List Unified Organizations - List Liferay organizations mapped to the IAM unified organization schema. Always requests the full organization hierarchy, since the unified schema has no parent/child fields.
Get Unified Organization - Retrieve a single Liferay organization by id, mapped to the IAM unified organization schema.
List Unified Resource Types - List unified resource types in Liferay.
List Unified Resource Users - List unified resource users in Liferay.
List Unified Roles - List Liferay roles mapped to the IAM unified role schema. Includes regular, site, organization, and account-scoped roles.
Get Unified Role - Retrieve a single Liferay role by id, mapped to the IAM unified role schema.
List Unified Users - List Liferay user accounts mapped to the IAM unified user schema. Wraps GET /o/headless-admin-user/v1.0/user-accounts.
Get Unified User - Retrieve a single Liferay user account by id, mapped to the IAM unified user schema.
List Organizations - Retrieve a paginated list of organizations from Liferay
Get Organization - Retrieve an organization by ID
Update Organization - Update an existing organization
Create Organization - Create a new organization in Liferay
List Organization User Accounts - List users belonging to an organization
List Child Organizations - List child organizations under a parent organization
Delete Organization - Delete an organization by ID
List Roles - Retrieve a paginated list of roles from Liferay
Get Role - Retrieve a role by ID
Get Role By External Reference Code - Retrieve a role by its external reference code (ERC), a unique identifier string assigned when the role is synced from an external system
Create Role - Create a new role in Liferay
Update Role - Update an existing role
Delete Role - Delete a role by ID
Assign Role To User - Grant a role to a user account. Both IDs must be resolved from prior list/lookup calls — do not pass names, emails, or guessed numeric IDs.
Unassign Role From User - Remove a role from a user account
Get Site - Retrieve a site by ID
Get Site By Friendly URL Path - Retrieve a site by its human-readable URL path
List Site User Accounts - List users who are members of a specific site. Scope is restricted to users explicitly assigned to the given siteId — users that exist in the instance but are not site members will not appear here. An empty `items` array is a valid result meaning no site member matched the filter; do not retry with broader filters unless the user asks. For instance-wide user searches (including users not assigned to any site), use list_user_accounts.
List My Sites - Retrieve all sites the current user has access to. PREFERRED discovery tool when a site name or friendly URL is known but the numeric siteId is not — use this before any site-scoped operation to look up the siteId.
List Structured Content Folders - Retrieve a paginated list of structured content folders for a site
Create Structured Content Folder - Create a new folder for organizing structured content
Get Structured Content Folder - Retrieve a structured content folder by ID
Update Structured Content Folder - Update an existing structured content folder
List Structured Content Folder Subfolders - List subfolders of a structured content folder
List Structured Content Folder Contents - List structured content articles inside a folder
Delete Structured Content Folder - Delete a structured content folder by ID
List Structured Contents - Retrieve a paginated list of structured content (web content) for a site
Create Structured Content - Create a new structured content article (web content) in a site
Update Structured Content - Partially update an existing structured content article (title, contentFields, description, keywords, friendlyUrlPath, externalReferenceCode). Does NOT support moving the article to a different folder — that field is not accepted in this PATCH body.
Delete Structured Content - Delete a structured content article by ID
Get Structured Content - Retrieve a structured content article by ID
List Site Taxonomy Vocabularies - Retrieve taxonomy vocabularies defined in a site
List Taxonomy Categories - List taxonomy categories under a taxonomy vocabulary
List User Groups - Retrieve a paginated list of user groups from Liferay
Get User Group - Retrieve a user group by ID
Update User Group - Update an existing user group
Create User Group - Create a new user group in Liferay
List User Group Members - List users belonging to a user group
Add Users To User Group - Add users to a user group
Remove Users From User Group - Remove users from a user group
Delete User Group - Permanently delete a user group by ID. Returns 403 Forbidden for system-managed or otherwise non-deletable groups; treat 403 as "this specific group cannot be deleted" rather than a transient error to retry.
List User Accounts - Retrieve a paginated list of portal user accounts from Liferay with optional search/filter. NOT the preferred tool when the prompt already provides an email address — use get_user_account_by_email_address for direct single-user lookup by email. Use this action for name/keyword searches, status filters, or browsing.
Get User Account - Retrieve a single user account by ID
Get User Account By Email Address - PREFERRED tool for looking up a single user account by email address. Use this whenever the prompt provides an email and asks to "pull up", "find", "look up", or "get" the user — not list_user_accounts (which searches/filters portal users) and not list_accounts (which lists B2B business accounts, a different resource). Returns 404 when no user is registered under the supplied email; treat that 404 as the negative answer ("no user with this email") and report it directly to the caller rather than retrying with variants or abandoning the workflow.
List User Accounts By Status - List users filtered by status
List User Groups For User - List the user groups that a specific user belongs to. Requires a userAccountId — use list_user_accounts or get_user_account_by_email_address first to obtain the user's numeric ID.
Get My User Account - Retrieve the currently authenticated user's account
Create User Account - Create a new user account in Liferay. Returns 409 Conflict when a user with the same email or screenName already exists; treat 409 as "user already exists" and use get_user_account_by_email_address to retrieve the existing user rather than retrying the create or treating it as a hard failure.
Update User Account - Update an existing user account
Delete User Account - Delete a user account by ID
Liferay Webhook Events
10 real-time Liferay events your AI agent can subscribe to.
10 Events
- Active Check Responds with 200 OK to Liferay webhook deliveries that carry no recognizable event payload.
- User Created Processes Liferay user created events, fired when a user account is added to the instance.
- User Updated Processes Liferay user updated events, fired when a user account is modified.
- User Deleted Processes Liferay user deleted events, fired when a user account is removed from the instance.
- Account Created Processes Liferay account created events, fired when an account (business/person account) is added.
- Account Updated Processes Liferay account updated events, fired when an account is modified.
- Account Deleted Processes Liferay account deleted events, fired when an account is removed.
- Organization Created Processes Liferay organization created events, fired when an organization is added.
- Organization Updated Processes Liferay organization updated events, fired when an organization is modified.
- Organization Deleted Processes Liferay organization deleted events, fired when an organization is removed.
Do More, Build Less
Integration Infrastructure for Liferay AI Agents
"What impressed us most about StackOne is its ambition and clarity. They're creating infrastructure that modern software and the entire AI agent ecosystem can rely on. The depth of secure integrations, the pace of delivery, and the team's foresight into AI's future uniquely position StackOne to redefine this category."
Luna Schmid, Partner at GV
"We've been impressed by how quickly and deeply StackOne integrates with complex enterprise systems -- and now, with their focus on agent-to-agent interoperability, they're unlocking even more powerful use cases for customers. StackOne delivers all of the above in a universal layer -- without compromise."
Barbry McGann, SVP at Workday Ventures
Product Teams Love Building Agent Integrations With StackOne
Agentic Automation
A US medical research organisation
Connectors for workflow builders
Agentic Connectors
Scroll to explore
Liferay AI agent integration resources
Webhooks for AI agents: why agentic workflows need them purpose-built
AI agents can act the moment a system changes, using webhooks. But webhooks built for software hit three limits in agentic workflows. Here is how to fix each.
7 min read
Agentic Context Engineering: Why AI Agents Kill Their Own Context Windows
AI agents exceed their context windows without knowing it. Six failure patterns and seven survival architectures for agentic context engineering.
15 min
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Liferay integration FAQ
Do I need to create my own auth app to connect Liferay to StackOne?
Yes, you need an auth app inside your Liferay instance. Liferay calls this an "OAuth2 application" (created under Control Panel > Security > OAuth2 Administration). Once created, paste the Client ID and Secret into the StackOne dashboard auth config for the Liferay connector. Since Liferay is self-hosted, StackOne can't host a shared app. See the Liferay auth docs.
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.