# IFS Cloud for API Task Capability

## Overview <a href="#overview" id="overview"></a>

The IFS Cloud Integration connects IFS Loops to your IFS Cloud environment to pull service requests, knowledge articles, and Projection APIs. It uses OAuth client credentials for authentication, which are generated directly in IFS Cloud and entered during setup in IFS Loops.

## Setup instructions

### Create OAuth Client in IFS Cloud

{% stepper %}
{% step %}
Log in to your IFS Cloud account.
{% endstep %}

{% step %}
Search for IAM Clients.
{% endstep %}

{% step %}
Click on the "+" (Add) button to create a new client (or use an existing one).
{% endstep %}

{% step %}
Enter a unique Client ID.
{% endstep %}

{% step %}
Enable the following options:

1. Enable Client
2. Enable Service Account
   {% endstep %}

{% step %}
(Optional) Add a description.
{% endstep %}

{% step %}
Click OK.
{% endstep %}

{% step %}
Copy the Client Secret.
{% endstep %}
{% endstepper %}

### Add IFS Cloud Integration in IFS Loops

{% stepper %}
{% step %}
Log in to the IFS Loops platform using your credentials.
{% endstep %}

{% step %}
Navigate to the Connectors section from the sidebar.
{% endstep %}

{% step %}
Click on the Add Integration button.
{% endstep %}

{% step %}
Choose IFS Cloud from the list.
{% endstep %}

{% step %}
Provide the following details:

1. **Integration Name:** Enter a unique name.
2. Select Capability:
   1. **APITask:** To perform API operations.
3. **Domain Name:** Enter your IFS Cloud domain. Extract only the domain part from the full URL. For example, from <https://example-instance.ifscloud.com/>, use only example-instance.ifscloud.com.
4. **Namespace:** Enter the required namespace.
5. **Client ID & Client Secret:** Use the values created in IFS Cloud.
6. **IAM Client Has Offline Access Scope:**
   1. Select Yes if your IAM client has offline\_scope access
   2. Otherwise, keep it as No.
      {% endstep %}

{% step %}
Click on the Connect button.&#x20;
{% endstep %}

{% step %}
On success, you will see a popup: "Integration Configured Successfully"
{% endstep %}
{% endstepper %}

### Import APIs as tools

{% stepper %}
{% step %}
Go to your IFS Cloud integration.
{% endstep %}

{% step %}
Click on the Edit button.
{% endstep %}

{% step %}
Navigate to the API tab.
{% endstep %}

{% step %}
Click on the Import button.
{% endstep %}

{% step %}
You will see a list of available Projection APIs.&#x20;

1. Search for the APIs you want to import as tools.
   {% endstep %}

{% step %}
To import APIs as tools:

1. Click on the View API Details (👁) icon.
2. Then click on Import.
   {% endstep %}
   {% endstepper %}

{% hint style="info" %}
If no APIs are visible, you need to run the job to fetch APIs from IFS Cloud. (Refer to Launch Data Ingestion Job.)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.theloops.io/agenticstudio/integrations/ifs-cloud-for-api-task-capability.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.