How to build a Custom GPT using the Wardley Mapping API (Part 1)

Exploring the Wardley Maps Crew API: Unlocking New Capabilities for OpenAI GPTs

Introduction

The Wardley Maps Crew API offers a powerful suite of tools for interacting with Wardley Maps, enabling developers to create, convert, and fetch map data seamlessly. I will walk you through the key features of the API and demonstrate how you can integrate it with OpenAI GPTs to unlock new capabilities and insights.

Introduction to Wardley?Maps

Wardley Maps are a strategic tool used to visualise the components and evolution of business activities. They help organisations understand their landscape, identify opportunities, and make informed decisions. With the Wardley Maps Crew API, you can programmatically interact with these maps, making it easier to incorporate their insights into various applications.

Key Features of the Wardley Maps Crew?API

The Wardley Maps Crew API provides several endpoints for managing Wardley Maps:

1. Generate Wardley Map from Text: Create a Wardley Map image from text input.
2. Generate Wardley Map from ID: Generate a map image using a unique map ID.
3. Save Wardley Map: Save a map to the create.wardleymaps.ai platform and get an edit link.
4. Fetch Wardley Map: Retrieve map content using a map ID.
5. Convert OWM to Various Formats: Convert Open Wardley Map (OWM) data to TOML, JSON, YAML, PNG, and SVG formats.

ChatGPT

To fully leverage the capabilities of OpenAI GPTs with the Wardley Maps Crew API, ensure you have access to OpenAI’s services. You’ll need access to ChatGPT.

Wardley Maps Crew?API

Subscription

Choose a suitable subscription plan that meets your needs. The API offers various plans, including free and paid tiers, each with different limits and features.

All the plans are FREE for 90 days. No credit card details are required. Pick the ChatGPT plan.

Create an?Account

Then you will need to create an account on the Wardley Maps API platform. Sign up by providing the necessary details and verifying your email.

API Key

Once you’ve subscribed to a plan, navigate to your subscription settings to see your API key. This key will be used to authenticate your requests to the Wardley Maps Crew API.

ChatGPT

We are now going to create a GPT. Click here to create a GPT. Here is more information from OpenAI on creating GPTs.

Give your GPT a name and description and some basic instructions.

‘You are a friendly Wardley Mapping Assistant’

Untick the ‘web browsing’ and ‘DALL-E’ support. We don’t need them today.

Create Actions

Click ‘Create new action’

You should now see the following screen.

Authentication

Using the API key we created earlier, click on Authentication and give it your API key. Select ‘API Key’ and ‘Bearer’.

Actions

Select ‘Import from URL’

Enter the URL below and click import.

https://api.wardleymaps.ai/open-api-spec.j        

Enter the URL below and click import.

https://api.wardleymaps.ai/open-api-spec.json        

You should see something like this. Ignore the red errors for now.

Available Actions

At the bottom of the screen you should see the available actions.

Lets test a few of these. Just click on Test for the generateWardleyMapFromText action.

In the right hand preview column you should see something like this.

Congratulations, your GPT is now working. Make sure you click ‘Create’ in the top right hand corner and start testing your GPT.

Improvements

You will need to spend some time configuring the GPT to use the Actions/APIs, but we will cover that in the next post.