Access the developer portal

The developer portal provides everything you need to discover, test, and consume APIs.

Log in to the portal

How you log in depends on whether your workspace uses Workato Identity:

When an admin invites you to the developer portal, you receive an email with a link to access the portal.

Log in with Workato Identity

Follow the Invited user tab if you received a portal invitation email. Follow the JIT user tab if your organization uses SSO with just-in-time (JIT) provisioning and you didn't receive an invitation.


PORTAL ACCESS

Contact your admin for the portal URL and to confirm which access method applies to you.

After you log in, you can browse your assigned API collections, discover new ones, test endpoints, and manage your API keys.

Browse API collections

You can access your assigned API collections in the My APIs tab. Selecting a collection opens its documentation, where you can explore endpoint methods, descriptions, and schemas. The documentation includes example requests and responses. You can also download the OpenAPI specifications.

Browse API collectionsBrowse API collections

Discover new APIs

The Discover new APIs tab provides access to additional API collections. Browse collections to find APIs that match your needs, and request access directly through the portal.

Request access to new APIs

Complete the following steps to request access to new APIs:

1

Go to the Discover new APIs tab to browse available API collections.

Discover new APIsDiscover new APIs

2

Select the collection you plan to access and click Request access.

Request access to an API collectionRequest access to an API collection

3

Provide a reason for your request and click Send request. An admin reviews your request and determines whether to approve or reject it.

Request accessRequest access

The requested APIs appear in your My APIs tab if your request is approved, granting you access to their endpoints and documentation.

Collection added to My APIsCollection added to My APIs

Test endpoints

You can test API endpoints directly in the portal to validate their functionality. You must create an API key before testing if you don't already have one.

Complete the following steps to test an endpoint:

1

Go to your assigned collection in the My APIs tab and choose the endpoint you plan to test.

2

Click Try it out to open the testing interface.

Try out endpointClick Try it out

3

Click Execute to send a test request.

Execute endpointClick Execute

4

Review the response details, including status codes, headers, and payloads, to confirm the endpoint’s behavior.

Manage and create API keys

Use the Manage API keys page to create and manage your API keys. You can define security parameters such as allowed and blocked IP addresses.

Complete the following steps to create an API key:

1

Click your profile icon, then select Manage API keys in the drop-down menu.

Manage API keysManage API keys

2

Click Create API key.

Create new API keyCreate new API key

3

Enter a name in the API key name field.

Create new API keyProvide an API key name

4

Optional. Enter allowed IP addresses in the Allowed IPs field to restrict requests for enhanced security. To add multiple IP addresses, separate them using commas or define a range (106.226.100.3/20).

5

Optional. Enter blocked IP addresses in the Blocked IPs field to prevent requests from specific IP addresses. Blocked IPs take precedence over allowed IPs. Requests from an IP address are denied if it appears on both lists.

6

Click Generate to create the API key. Workato displays the generated token. Save this token securely, as it won’t display again. If you lose the token, you can refresh the key to generate a new one. Refreshing invalidates the existing token.

After creating the key, it appears on the Manage API keys page. You can use this page to view the token’s details or refresh, deactivate, or delete the key if required.

Search with AIRO

AIRO is a smart search capability in the developer portal. You can ask natural-language questions and get help with developer tasks, such as endpoint recommendations, code snippets, and links to documentation.

How AIRO works

AIRO interprets your natural-language questions and assists with developer tasks in the portal, such as recommending endpoints, generating code, and surfacing related documentation. Responses are scoped to API collections that are published in the portal.

Search for an API

You can search for an API in the following ways:

  • Search field: Type a keyword in the Search collections field, then select one of the suggested Ask AIRO prompts. The portal returns a single response inline. Click Continue in chat if you have follow-up questions.
  • AIRO chat: Click Ask AIRO to open the chat directly, or click the Search collections field and select Open AIRO from the drop-down menu. The chat supports multi-turn conversation, so you can ask follow-ups in the same session.

AIRO typically responds with the following information:

  • A natural-language explanation of which endpoint to use and how to use it.
  • A cURL code example with placeholder authentication.
  • A Related documentation section linking to the recommended endpoint and its parent collection.

AIRO responds with a code example and related documentationAIRO responds with a code example and related documentation

VERIFY AI-GENERATED CONTENT

AIRO generates responses using an AI model. Note the following when reviewing responses:

  • Responses are scoped to API collections that are published in your portal and that you have access to or can request access to.
  • Code examples use placeholder authentication. Replace this placeholder with one of your own API keys before sending the request.
  • Endpoint paths, parameter names, and example values shown in responses can be inaccurate. Verify generated content against the linked endpoint documentation before using it.

Last updated: