Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypha-docs.plinqx.app/llms.txt

Use this file to discover all available pages before exploring further.

Imported Tools let you quickly add tools from any API that provides OpenAPI or Swagger documentation. Simply upload a spec file and Plinqx automatically generates tools.

​
Overview

Import Tools is perfect for:
  • APIs with OpenAPI/Swagger documentation
  • Third-party services with published specs
  • Internal APIs with documented endpoints
  • Rapidly onboarding multiple tools at once

​
Importing Tools

1

Navigate to Imported Tools

Click Imported Tools in the sidebar.
2

Start Import

Click Import Tools and choose your import method:
  • Upload File: Upload an OpenAPI/Swagger JSON or YAML file
  • From URL: Provide a URL to the OpenAPI spec
3

Review Tools

Plinqx parses the spec and shows you all available endpoints.
4

Select Tools

Choose which endpoints to import as tools.
5

Complete Import

Click Import to create the tools.

​
Import Groups

Imported tools are organized into Import Groups - collections of tools from the same OpenAPI spec.

​
Managing Import Groups

  • View Tools: See all tools in an import group
  • Re-import: Update tools if the OpenAPI spec changes
  • Delete: Remove the entire import group and its tools

​
Tool Status

Imported tools have statuses:
StatusDescription
DraftImported but not yet published
PublishedAvailable to AI clients via collections
ErrorImport failed or tool configuration invalid

​
Editing Imported Tools

You can edit imported tools just like custom tools:
1

Open Tool

Click on a tool in the import group.
2

Edit Configuration

Modify endpoint, authentication, parameters, or response mapping.
3

Save Changes

Click Save to update the tool.
Editing an imported tool doesn’t affect the original OpenAPI spec. You can re-import to reset changes.

​
Bulk Publishing

Publish multiple tools at once:
1

Select Tools

Check the boxes next to tools you want to publish.
2

Bulk Publish

Click Publish Selected to publish all at once.

​
Store Exposure

Configure store exposure for imported tools:
  • Click the store indicators (C, A, G) next to each tool
  • Toggle exposure for ChatGPT, Claude, or Gemini
  • Changes save automatically

​
Re-importing

If the OpenAPI spec changes:
1

Open Import Group

Navigate to the import group details.
2

Re-import

Click Re-import and provide the updated spec.
3

Review Changes

Plinqx shows what’s new, changed, or removed.
Re-importing may overwrite manual edits. Review changes carefully before confirming.

​
Best Practices

Validate Specs

Ensure your OpenAPI spec is valid before importing

Review Tools

Review imported tools before publishing to collections

Test First

Test imported tools in the Playground before production use

Document Changes

Keep track of manual edits if you plan to re-import

​
Next Steps

Add to Collections

Add imported tools to collections

Test Tools

Test imported tools in the Playground