# Darwin

APIs for Darwin.

 - [GET /darwin/v1/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_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. A StackOne integ
 - [POST /darwin/v1/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_save_action_v1_actions_post.md): save action Parameters: - tenant_id: Identifier for the tenant. Returns: - status.
 - [DELETE /darwin/v1/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_delete_integration_v1_actions_delete.md): Delete Actions Parameters: - tenant_id: Identifier for the tenant. Returns: - status:
 - [GET /darwin/v1/actions/count](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_actions_count_per_integration_v1_actions_count_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.
 - [POST /darwin/v1/action-parameters](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_fetch_action_parameters_v1_action_parameters_post.md): Retrieve a Fetch Action parameters. Parameters: - tenant_id: Identifier for the tenant. - action_service: Service to fetch actions. Returns: - A actions details matching the criteria.
 - [POST /darwin/v1/actions/connector](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_save_stackone_integrations_v1_actions_connector_post.md): save code.
 - [POST /darwin/v1/actions/openapi-file-upload](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_upload_openapi_spec_file_v1_actions_openapi_file_upload_post.md): Openapi file upload.
 - [PUT /darwin/v1/actions/openapi-file-upload](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_update_openapi_spec_file_v1_actions_openapi_file_upload_put.md): Update the openapi file of an existing integration. The integration_name, access_level and security data cannot be changed; only the actions and the openapi spec are updated.
 - [GET /darwin/v1/actions/openapi/download](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_download_openapi_spec_file_v1_actions_openapi_download_get.md): Download the openapi file of an integration, in the format it was uploaded.
 - [GET /darwin/v1/actions/openapi/details](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_openapi_spec_file_details_v1_actions_openapi_details_get.md): Details an integration's openapi file was uploaded with (the request_data, without the file). Secret values are masked.
 - [GET /darwin/v1/integrations/workato/connection_mapper](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_workato_user_mapper_v1_integrations_workato_connection_mapper_get.md): Retrieve a workato connection_mapper. Parameters: - tenant_id: Identifier for the tenant.
 - [POST /darwin/v1/integrations/workato/connection_mapper](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_save_user_mapper_v1_integrations_workato_connection_mapper_post.md): save connection_mapper Parameters: - tenant_id: Identifier for the tenant. Returns: - status.
 - [GET /darwin/v1/integrations/connection_mapper](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_user_mapper_v1_integrations_connection_mapper_get.md): Retrieve a connection_mapper. Parameters: - tenant_id: Identifier for the tenant.
 - [GET /darwin/v1/integrations/{integration_name}/access_params](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_access_params_v1_integrations_integration_name_access_params_get.md): get_access_params Parameters: - tenant_id: Identifier for the tenant. - configuration_service: Service to fetch integrations. Returns: - status:
 - [POST /darwin/v1/integrations/{integration_name}/access_params](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_save_access_params_v1_integrations_integration_name_access_params_post.md): save_access_params Parameters: - tenant_id: Identifier for the tenant. - configuration_service: Service to fetch integrations. Returns: - status:
 - [GET /darwin/v1/actions/functions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_actions_as_functions_v1_actions_functions_get.md)
 - [POST /darwin/v1/actions/functions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_fetch_actions_as_functions_v1_actions_functions_post.md)
 - [POST /darwin/v1/actions/execute](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_execute_actions_v1_actions_execute_post.md): Execute Action.
 - [GET /darwin/v1/reports/downloads/{tenant_id}/{execution_id}/{file}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_download_file_v1_reports_downloads_tenant_id_execution_id_file_get.md)
 - [POST /darwin/v1/actions/custom/execute](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_execute_actions_v1_actions_custom_execute_post.md): Execute an Action. Request Body: - tenant_id: Identifier for the tenant. - configuration_service: Service to fetch actions. - action_id: Identifier for the Action. - action_name: Name of the Action. -
 - [GET /darwin/auth/slack/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_slack_callback_auth_slack_callback_get.md)
 - [POST /darwin/auth/generate-url](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_auth_url_generate_auth_generate_url_post.md)
 - [GET /darwin/auth/status](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_auth_status_auth_status_get.md)
 - [DELETE /darwin/auth/revert](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_delete_integration_access_credentials_auth_revert_delete.md)
 - [POST /darwin/auth/outlook/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_outlook_callback_auth_outlook_callback_post.md)
 - [POST /darwin/auth/test-connection](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_test_connection_auth_test_connection_post.md)
 - [POST /darwin/auth/openapi/generate-url](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_generate_url_auth_openapi_generate_url_post.md)
 - [GET /darwin/auth/openapi/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_callback_auth_openapi_callback_get.md)
 - [GET /darwin/v1/connectors](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_list_connectors_v1_connectors_get.md): Retrieve the Darwin connectors available to the project. Parameters: - filter: free-text search across key, name, description and categories. - key / category: exact-match narrowing. - page / page_siz
 - [GET /darwin/v1/connectors/events](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_list_connector_events_v1_connectors_events_get.md): List the connector events received for the account linked on an integration. Connector events (e.g. `github_webhook_pull_request`) reach `/connectors/events/callback` once they are enabled on the conn
 - [GET /darwin/v1/connectors/actions](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_list_actions_v1_connectors_actions_get.md): List connectors and the actions they expose. Parameters: - connectors / account_ids / action_key: narrow the listing. - search: free-text over provider names and action labels. - include / exclude: co
 - [GET /darwin/v1/connectors/{connector_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_connector_v1_connectors_connector_id_get.md): Retrieve a single StackOne connector. Parameters: - connector_id: key[@version][~owner] identifier. - version / owner: override what the id resolves to. - connector_profile_id: mark which actions the
 - [GET /darwin/v1/connectors/{connector_id}/actions/{action_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_connector_action_v1_connectors_connector_id_actions_action_id_get.md): Retrieve the full definition of one action on a StackOne connector. Parameters: - connector_id: key[@version][~owner] identifier. - action_id: the action to describe, e.g. hibob_list_employees. - vers
 - [GET /darwin/v1/connector-profiles](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_list_connector_profiles_v1_connector_profiles_get.md): List the StackOne connector profiles configured in the project. Parameters: - connector_key: restrict to one or more connectors. - active: restrict by active state. - page / page_size: pagination. - e
 - [POST /darwin/v1/connector-profiles](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_create_connector_profile_v1_connector_profiles_post.md): Create a StackOne connector profile. Request Body: - connector_key, authentication_config_key, name: required. - environment / active / is_default / version / pinned_version: default to production, t
 - [GET /darwin/v1/connector-profiles/{profile_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_get_connector_profile_v1_connector_profiles_profile_id_get.md): Retrieve one StackOne connector profile. Parameters: - profile_id: the profile's unique identifier. - expand: pull in the connector, version or count fields. Returns: - The profile with its setup fie
 - [DELETE /darwin/v1/connector-profiles/{profile_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_delete_connector_profile_v1_connector_profiles_profile_id_delete.md): Delete a StackOne connector profile. Deleting also removes the profile's webhook subscriptions and stored secrets. A profile that still has linked accounts cannot be deleted, and StackOne reports that
 - [PATCH /darwin/v1/connector-profiles/{profile_id}](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_update_connector_profile_v1_connector_profiles_profile_id_patch.md): Update a StackOne connector profile. Send only the fields to change. Request Body: - Every field is optional; omitted fields keep their stored values. - setup_fields / secrets replace the stored set w
 - [POST /darwin/v1/connectors/auth-links](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_create_auth_link_v1_connectors_auth_links_post.md): Generate an account-linking auth link for an end-user. Creates a StackOne connect session (`POST /connect_sessions`) and returns its `auth_link_url` — the link the end-user opens to connect their acco
 - [POST /darwin/v1/connectors/actions/execute](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_execute_action_v1_connectors_actions_execute_post.md): Execute a StackOne action against a linked account. Calls `POST /actions/rpc`, which routes to the account's provider, handles provider authentication and returns normalized data. Request Body: - acti
 - [POST /darwin/v1/connectors/accounts/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_receive_account_event_v1_connectors_accounts_callback_post.md): Receive an account lifecycle event from StackOne. This is the URL registered by the startup webhook registration (`STACKONE_ACCOUNT_EVENT_CALLBACK_URL`), so StackOne — not an authenticated caller — is
 - [POST /darwin/v1/connectors/events/callback](https://docs.businessai.uniphorecloud.com/api-reference/api/darwin/darwin_receive_connector_event_v1_connectors_events_callback_post.md): Receive a connector event from StackOne. This is the URL of the connector events webhook registered at startup (`STACKONE_CONNECTOR_EVENT_CALLBACK_URL`); enable events on a connector profile and route