---
canonical: https://docs.jentic.com/guides/create-agent-workflows/
representation: markdown-alternate
# Canonical page: https://docs.jentic.com/guides/create-agent-workflows/
# This is the Markdown alternate of the page above.
title: "Create Agent Workflows from Existing APIs"
description: >-
  Learn how to request deterministic, multi-step agent workflows for Jentic Public APIs,
  described with the open Arazzo standard so any compatible agent can run.
---

# Create Agent Workflows from Existing APIs

The Jentic Public APIs knowledge base goes beyond handling individual API calls—it orchestrates **agent workflows**: deterministic, multi-step sequences that guide agents toward specific goals.

Workflows in Jentic Public APIs are described using **Arazzo**, an open standard developed under the OpenAPI Initiative and the Linux Foundation. This allows any compatible tool or AI agent to reliably execute these pre-defined workflows.

> **Important:** To request a new workflow, please use the GitHub issue template named **"Generate Arazzo Specification for Jentic OpenAPI"**.  

> 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.

## Prerequisites for Requesting a Workflow

Before submitting a workflow request, please ensure the following:

*   The core API(s) needed for the workflow **must already be integrated into the Jentic Public APIs repository**. (If not, please first submit a request via [Add API Integrations](./add-api-integration.md)).
*   You have a clear, repeatable sequence of operations in mind (e.g., "1. Translate text using DeepL. 2. Send the translated text via a SendGrid email.").

## How to Request a New Agent Workflow

### 1. Open a New Issue on GitHub
* Navigate to the [Jentic Public APIs Issues page](https://github.com/jentic/jentic-public-apis/issues).
* Click the **"New issue"** button.
* Select the **"Generate Arazzo Specification for Jentic OpenAPI"** issue template.

### 2. Fill Out the Template

#### **OpenAPI Description URL (required)**
Paste the **RAW** URL to the spec file that is already in the Jentic Public APIs repo.

```text
✅ https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/vendor.com/api/version/openapi.json
❌ https://github.com/jentic/jentic-public-apis/blob/main/apis/openapi/vendor.com/api/version/openapi.json
```

Why RAW? The generator fetches the JSON/YAML directly. Links to GitHub's web UI won't work.

#### **Request Workflow Descriptions**  

Describe the workflows you want, one bullet per workflow.
If you leave this section blank, the generator will try to auto-discover common patterns.

#### **Additional Information (optional)**
Any additional information that might help reviewers..

**Examples of Workflow Descriptions:**  
- Create a new user and assign them a role  
- Authenticate a user and fetch their profile  
- Submit an order and retrieve order status

Tip: Plain English descriptions are fine, the maintainer or bot will map them to specific endpoints.

#### Example of a Completed Template

```text
### OpenAPI Description URL
openapi_url: https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/linqr.app/main/2.0/openapi.json

### Additional Information

### Request Workflow Descriptions
#### Workflow Descriptions (Optional)
- Generate and email a custom QR code
- Create a Wifi QR code and display on a web page
- Batch generate QR codes and archive them
```

### 3. What Happens Next?

- We process this, and create an Arazzo file using your bullet points.
- Maintainers will review
- The workflow file(s) land in `workflows/<provider>/<api>/...` and your issue is closed with links.
- Test & iterate: run with `arazzo-runner run <workflow>`. If tweaks are needed, reply in the issue or open a follow-up.

### Need Help?
- **Discord**: Quick Q&A, brainstorming ideas.
- **Docs**: See [Add API Integrations](./add-api-integration.md) if your API isn't imported yet.
- **Core contributions**: Want to open a PR instead of an issue? See [Contribute to Jentic Public APIs Core](./contributing.md).

## Additional Support

If you have questions about defining your workflow or using the issue template, please ask in the [Discord server](https://discord.gg/xRResx3ZNW). Our community and maintainers are happy to assist!

➡️ **Ready to request a workflow?** [Go to the new issue page](https://github.com/jentic/jentic-public-apis/issues/new/choose) and select the **"Generate Arazzo Specification for Jentic OpenAPI"** template.