# Action Orchestrator

APIs for Actions Orchestration.

## List All Categories

 - [GET /action-orchestrator/v1/categories](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_categories_v1_categories_get.md): Retrieve a list of categories.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch categories.

Returns:
- A list of categories matching the criteria.

## List All Integrations

 - [GET /action-orchestrator/v1/integrations](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_integrations_v1_integrations_get.md): Retrieve a list of integrations.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch integrations.

Returns:
- A list of integrations matching the criteria.

## Save Integration

 - [POST /action-orchestrator/v1/integrations](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/save_integration_v1_integrations_post.md): save integration

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## Delete Integration

 - [DELETE /action-orchestrator/v1/integrations/{integration_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/delete_integration_v1_integrations__integration_id__delete.md): Delete Integration

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch integrations.

Returns:
- status:

## Get Access Params

 - [GET /action-orchestrator/v1/integrations/{integration_id}/access_params](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_access_params_v1_integrations__integration_id__access_params_get.md): get_access_params

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch integrations.

Returns:
- status:

## Save Access Params

 - [POST /action-orchestrator/v1/integrations/{integration_id}/access_params](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/save_access_params_v1_integrations__integration_id__access_params_post.md): save_access_params

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch integrations.

Returns:
- status:

## Get Workato User Mapper

 - [GET /action-orchestrator/v1/integrations/workato/connection_mapper](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_workato_user_mapper_v1_integrations_workato_connection_mapper_get.md): Retrieve a workato user_mapper.

Parameters:
- tenant_id: Identifier for the tenant.

## Save User Mapper

 - [POST /action-orchestrator/v1/integrations/workato/connection_mapper](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/save_user_mapper_v1_integrations_workato_connection_mapper_post.md): save user_mapper
Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## Get Integration Resources

 - [POST /action-orchestrator/v1/integrations/resources](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_integration_resources_v1_integrations_resources_post.md): Save integration

Parameters:
- tenant_id: Identifier for the tenant.
- request: List of integration strings.
- user_id: ID of the user making the request.

Returns:
- CommonResponse with status.

## List All Actions

 - [GET /action-orchestrator/v1/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_actions_v1_actions_get.md): Retrieve a list of actions.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch actions.

Returns:
- A list of actions matching the criteria.

## Save Action

 - [POST /action-orchestrator/v1/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/save_action_v1_actions_post.md): save action

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## List All Mcp Actions

 - [GET /action-orchestrator/v1/mcp/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_mcp_actions_v1_mcp_actions_get.md): Retrieve a list of all mcp actions.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch actions.

Returns:
- A list of actions matching the criteria.

## List All Integrations Actions

 - [GET /action-orchestrator/v1/integrations/actions/count](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_integrations_actions_v1_integrations_actions_count_get.md): Retrieve a list of integrations grouped with their actions.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch actions.

Returns:
- A list of integrations with their action names grouped together.

## List All Integrations Actions

 - [GET /action-orchestrator/v1/integrations/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_integrations_actions_v1_integrations_actions_get.md): Retrieve a list of integrations grouped with their actions.

Parameters:
- tenant_id: Identifier for the tenant.
- configuration_service: Service to fetch actions.

Returns:
- A list of integrations with their action names grouped together.

## Actions Count

 - [GET /action-orchestrator/v1/actions/count](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/actions_count_v1_actions_count_get.md): Retrieve a Actions count.

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- A Actions count matching the criteria.

## Test Mcp Registry Connection

 - [POST /action-orchestrator/v1/actions/mcp/servers/registry/connection-test](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/test_mcp_registry_connection_v1_actions_mcp_servers_registry_connection_test_post.md): Test Mcp Registry Connection

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## Get Mcp Registry Connection

 - [GET /action-orchestrator/v1/actions/mcp/servers/registry/connection](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_mcp_registry_connection_v1_actions_mcp_servers_registry_connection_get.md): Get Mcp Registry Connection

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- Mcp Registry Connection Details.

## Mcp Registry Connection

 - [POST /action-orchestrator/v1/actions/mcp/servers/registry/connection](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/mcp_registry_connection_v1_actions_mcp_servers_registry_connection_post.md): Mcp Registry Connection

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## List Mcp Servers

 - [GET /action-orchestrator/v1/actions/mcp/servers](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_mcp_servers_v1_actions_mcp_servers_get.md): Get list mcp servers

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- list mcp servers matching the criteria.

## Count Mcp Servers

 - [GET /action-orchestrator/v1/actions/mcp/servers/count](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/count_mcp_servers_v1_actions_mcp_servers_count_get.md): mcp servers count

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- count mcp servers

## List All Mcp Servers

 - [GET /action-orchestrator/v1/actions/mcp/servers/search](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_mcp_servers_v1_actions_mcp_servers_search_get.md): Retrieve a List all mcp servers.

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- A list of mcp servers matching the criteria.

## Get Mcp Server Registry

 - [GET /action-orchestrator/v1/actions/mcp/servers/registry](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_mcp_server_registry_v1_actions_mcp_servers_registry_get.md): Get mcp server registry

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## Registry Mcp Server

 - [POST /action-orchestrator/v1/actions/mcp/servers/registry](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/registry_mcp_server_v1_actions_mcp_servers_registry_post.md): Registry mcp server

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- status.

## Test Mcp Server Connection

 - [POST /action-orchestrator/v1/actions/mcp/servers/connection-test](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/test_mcp_server_connection_v1_actions_mcp_servers_connection_test_post.md): test mcp server connection

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- connection status.

## Get Mcp Server Details

 - [GET /action-orchestrator/v1/actions/mcp/servers/{qualified_name}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_mcp_server_details_v1_actions_mcp_servers__qualified_name__get.md): Get mcp server details

Parameters:
- tenant_id: Identifier for the tenant.

Returns:
- mcp server details matching the criteria.

## Get Mcp Server Tools

 - [GET /action-orchestrator/v1/actions/mcp/server-tools](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_mcp_server_tools_v1_actions_mcp_server_tools_get.md): Get all tools for a specific MCP server from the Smithery registry.

Parameters:
- tenant_id: Identifier for the tenant.
- qualified_name: Qualified name of the MCP server (e.g., '@smithery-ai/github').
- user_id: User identifier.

Returns:
- Dictionary with integration_name, integration_desc, and actions list.

## Save Code

 - [POST /action-orchestrator/v1/actions/code_configuration](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/save_code_v1_actions_code_configuration_post.md): save code.

## Get Code Configurations

 - [GET /action-orchestrator/v1/actions/code_configuration/{integration_name}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_code_configurations_v1_actions_code_configuration__integration_name__get.md): save code.

## Generate Workflow

 - [POST /action-orchestrator/v1/generate-workflow](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/generate_workflow_v1_generate_workflow_post.md)

## Upload Openapi Spec File

 - [POST /action-orchestrator/v1/actions/openapi-file-upload](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/upload_openapi_spec_file_v1_actions_openapi_file_upload_post.md): Openapi file upload.

## List All Integrations

 - [GET /action-orchestrator/v1/workato-integrations](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_all_integrations_v1_workato_integrations_get.md)

## Get Integration

 - [GET /action-orchestrator/v1/workato-integrations/{workato_integration}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_integration_v1_workato_integrations__workato_integration__get.md)

## Get Workato Action

 - [GET /action-orchestrator/v1/workato-actions/{action_name}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_workato_action_v1_workato_actions__action_name__get.md)

## Get Actions As Functions

 - [GET /action-orchestrator/v1/actions/functions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_actions_as_functions_v1_actions_functions_get.md)

## Fetch Actions As Functions

 - [POST /action-orchestrator/v1/actions/functions](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/fetch_actions_as_functions_v1_actions_functions_post.md)

## Action Code Snippet

 - [POST /action-orchestrator/v1/actions/code-snippets](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/action_code_snippet_v1_actions_code_snippets_post.md): Action Code Snippet

## Execute Action

 - [POST /action-orchestrator/v1/actions/execute](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/execute_action_v1_actions_execute_post.md): Execute Action.

## Upload The File

 - [POST /action-orchestrator/v1/actions/file-upload](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/upload_the_file_v1_actions_file_upload_post.md): file upload.

## Upload The File Resource

 - [POST /action-orchestrator/v1/actions/resource-upload](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/upload_the_file_resource_v1_actions_resource_upload_post.md): file upload.

## Callback

 - [GET /action-orchestrator/auth/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/callback_auth_callback_get.md)

## Get Auth Url Generate

 - [POST /action-orchestrator/auth/generate-url](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_auth_url_generate_auth_generate_url_post.md)

## Manual Callback

 - [POST /action-orchestrator/auth/manual-callback](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/manual_callback_auth_manual_callback_post.md)

## List Skill Packages

 - [GET /action-orchestrator/v1/packages](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_skill_packages_v1_packages_get.md): List all skill packages available for a tenant.

## Upload Skill Package

 - [POST /action-orchestrator/v1/packages](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/upload_skill_package_v1_packages_post.md): Upload a skill package ZIP file.

The package will be stored in S3 and package info will be saved to the database.
Returns the package info including a unique ID that can be used to
download the package later.

## Get Package Download Url

 - [GET /action-orchestrator/v1/packages/{id}/download-url](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_package_download_url_v1_packages__id__download_url_get.md): Get a presigned S3 download URL for a package.

The URL allows downloading the package ZIP file directly from S3.
URL expires after the specified duration (default: 1 hour).

## Delete Skill Package

 - [DELETE /action-orchestrator/v1/packages/{id}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/delete_skill_package_v1_packages__id__delete.md): Delete a skill package.

The package will be removed from both storage and database.

## Upload Or Update Skill

 - [POST /action-orchestrator/v1/skills/upload](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/upload_or_update_skill_v1_skills_upload_post.md): Upload a skill ZIP package (create or update).

- If no skill with this name exists for the tenant → creates a new skill at version 1.
- If a skill with this name already exists → increments the version and updates it.

The skill name is read from SKILL.md frontmatter. Use the optional name form field
to override it.

Set system_skill=true to register a globally shared skill (tenant_id=NULL in DB,
stored under skills/system/...). Useful for seeding built-in skills that every tenant
can use without re-uploading.

## List Skills

 - [GET /action-orchestrator/v1/skills](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/list_skills_v1_skills_get.md): List available skills for the tenant. Returns metadata by default.

## Get Skill

 - [GET /action-orchestrator/v1/skills/{skill_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_skill_v1_skills__skill_id__get.md): Get skill details.

Set include_full_content=true to receive the full SKILL.md body (Level 2 load).

## Delete Skill

 - [DELETE /action-orchestrator/v1/skills/{skill_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/delete_skill_v1_skills__skill_id__delete.md): Soft-delete a skill (sets is_active=false). System skills cannot be deleted.

## Get Skill Scan Result

 - [GET /action-orchestrator/v1/skills/{skill_id}/scan-result](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_skill_scan_result_v1_skills__skill_id__scan_result_get.md): Return the stored security scan result for a skill.

## Get Latest Skill Version

 - [GET /action-orchestrator/v1/skills/{skill_id}/versions/latest](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_latest_skill_version_v1_skills__skill_id__versions_latest_get.md): Get the maximum version number available for a skill.

## Get Skill Version

 - [GET /action-orchestrator/v1/skills/{skill_id}/versions/{version}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_skill_version_v1_skills__skill_id__versions__version__get.md): Get a specific version of a skill by (skill_id, version).

## Get Skill Resource

 - [GET /action-orchestrator/v1/skills/{skill_id}/resources/{resource_name}](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_skill_resource_v1_skills__skill_id__resources__resource_name__get.md): Download a single resource file from a skill (Level 3 load).

Called by crewai-agents SkillLoader to load resource files on demand.

## Execute Skill Script

 - [POST /action-orchestrator/v1/skills/{skill_id}/execute](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/execute_skill_script_v1_skills__skill_id__execute_post.md): Execute a skill script via the Python Executor sandbox.

Called by crewai-agents SkillTools instead of running subprocess locally.

## Get Skill Download Url

 - [GET /action-orchestrator/v1/skills/{skill_id}/download-url](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/get_skill_download_url_v1_skills__skill_id__download_url_get.md): Get a presigned S3 download URL for a skill.

The URL allows downloading the skill ZIP file directly from S3.
URL expires after the specified duration (default: 1 hour).

## Scan A Mcp Server For Vulnarabilities

 - [POST /action-orchestrator/v1/mcp-scanner/scan](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/scan_a_mcp_server_for_vulnarabilities_v1_mcp_scanner_scan_post.md): Scan mcp server

## Scan Existing Mcp Server For Vulnarabilities

 - [POST /action-orchestrator/v1/mcp-scanner/scan/job](https://docs.businessai.uniphorecloud.com/api-reference/api/action-orchestrator/scan_existing_mcp_server_for_vulnarabilities_v1_mcp_scanner_scan_job_post.md): Scan all mcp server