APIsConfiguration specifications
Managed Fusion’s REST APIs provide programmatic access to Managed Fusion services and features. You can use the APIs to automate tasks, integrate Managed Fusion with other systems, and build custom applications.
API authentication
There are two ways to authenticate when making API calls to Managed Fusion:
-
Basic authentication with a username and password
-
API key authentication
Authenticate with basic auth
You can use a Managed Fusion username and password to authenticate with Managed Fusion’s REST API. The user’s role and permissions must include access to the endpoints and methods you want to use.
Authenticate with an API key
You can use an API key instead of a username and password combination to power your search application or operations.
Pass your API key to Fusion using either apiKey
or x-api-key
, as in these examples:
curl -H "x-api-key: API_KEY" "https://FUSION_HOST/api/query/status"
curl -H "apiKey: API_KEY" "https://FUSION_HOST/api/query/status"
For more information, see API Keys.
Access API endpoints
API endpoints follow this pattern:
https://EXAMPLE_COMPANY.b.lucidworks.cloud/SERVICE_NAME/ENDPOINT
Example: https://EXAMPLE_COMPANY.b.lucidworks.cloud/query/query-pipelines
This is different than the paths in the Swagger/OpenAPI specs, which specify the paths as /api/SERVICE_NAME/ENDPOINT . Omit the /api base path when making REST API calls to Managed Fusion.
|
Discover API endpoints
There are several ways to discover Managed Fusion’s REST API endpoints.
Discover endpoints in the docs
Navigate this documentation to find the API for each Managed Fusion service. On any API documentation page, click the View API specification button to see the Swagger/OpenAPI specs for that service’s API endpoints.
You can also jump directly to the specs from here:
Access the Swagger UI
Access the Swagger UI at this URL:
https://EXAMPLE_COMPANY.b.lucidworks.cloud/swagger-ui/index.html
Use the Explore bar to switch between the APIs for different services.
For any API you want to see, enter /SERVICE_NAME/v3/api-docs
in the Explore bar.
For example, enter /indexing/v3/api-docs
to see the Indexing API:
Get the API specs in JSON
You can view or download the JSON-formatted API specs for each service by appending
/v3/api-docs
to the service’s base URL:
https://EXAMPLE_COMPANY.b.lucidworks.cloud/indexing/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/job-launcher/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/job-rest-server/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/connectors/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/query/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/apps-manager/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/ml-model-service/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/async-parsing/v3/api-docs
https://EXAMPLE_COMPANY.b.lucidworks.cloud/api/swagger