Add API Integrations¶

Got an API you’d love to see in the Jentic Public APIs knowledge base?
If you can point us to its OpenAPI specification, you’re only one GitHub issue away from having it live in the catalog that powers API Search.

Important: Please use the GitHub issue template named “Import OpenAPI to Jentic Public APIs” for all new API integration requests.
This template captures every detail our automation and reviewers need. While Discord is great for questions, GitHub issues are the official intake channel for new integrations.

How to Request a New API Integration¶

1. Open a New Issue on GitHub

   • Navigate to the Jentic Public APIs Issues page.
   • Click “New issue”.
   • Select the “Import OpenAPI to Jentic Public APIs” issue template.

2. Complete the Issue Template Provide:

   • OpenAPI Specification URL — direct raw link to the YAML/JSON file, or attach it.
   • Vendor name — e.g., apisetu.gov.in/asrb.
   • Additional Information (optional) — anything to help reviewers.

   Example

   ## OpenAPI Specification URL
   import_oas_url: https://api.apis.guru/v2/specs/apisetu.gov.in/asrb/3.0.0/openapi.json
   
   ## Vendor Name (Required)
   vendor_name: apisetu.gov.in/asrb
   

3. Submit and Track

   • Bots will label the issue automatically.
   • A maintainer reviews and verifies the spec.

4. Import and Publication Process

   • Spec is validated and placed in the OAK Repository Structure (apis/<provider>/<api>/<version>/openapi.json).
   • CI runs lint/format checks; automated PRs may fix small issues.
   • Once merged, the API is searchable and runnable within Jentic.

5. (Optional) Create Agent Workflows

   • After the API is integrated, request higher-level agent workflows using the “Generate Arazzo Specification for Jentic OpenAPI” issue template.
   • Learn more at Create Agent Workflows.

FAQ¶

Do I need to understand Arazzo?
No — you describe workflows in plain English, and our tooling generates the Arazzo spec.

What if I don't have an OpenAPI spec?
You can still open an issue. State that a spec isn’t available and link to the API’s docs. We may create one or help you generate it.

Can I request APIs with complex auth (e.g., OAuth 2.0)?
Yes — ideally the spec defines security schemes. Include details in the template to ensure correct configuration.

Additional Support¶

💬 Discord — community Q&A
📂 Public APIs – Overview
🗂 OAK Repository Structure

➡️ Ready to add an API?
Open the “Import OpenAPI to Jentic Public APIs” issue template

Contact Us Next