---
schema_version: "1"
id: c4ab0abbeb9cc9bb980d7e992514de53e92414f87260e378022a0ac3fa1a1f8d
title: Configuring an Apex REST Data Source (Managed Package)
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_configuring_an_apex_rest_data_source.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_configuring_an_apex_rest_data_source.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 479534e54aaf604c36b299ff045f9bd463c02d82bcbafff5e3b690aede6bedab
description: For the managed package runtime, configure a data source to use an Apex REST call to fetch data to populate fields on a Flexcard.
products:
  - Omnistudio
release: "264"
---
# Configuring an Apex REST Data Source (Managed Package)

For the managed package runtime, configure a data source to use an Apex REST call to fetch data to populate fields on a Flexcard.

See

![Managed Package app icon](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/resources-global/_corporate/images/managedpackageicon.png) This information is for Omnistudio for Managed Packages. For Omnistudio on standard runtime, see [Omnistudio Help](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_standard.htm&language=en_US).

[Introduction to Apex REST](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_rest_intro.htm).

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_note.png)

Note

For optimal flexibility and easier implementation, use an Integration Procedure as a data source to execute multiple actions in a single server call. See [Configuring an Integration Procedure Data Source (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_configuring_an_integration_procedure_data_source.htm&release=264.0.0&type=5 "For the managed package runtime, configure a data source to use a Vlocity Integration Procedure to execute multiple actions in a single server call.").

To configure Salesforce to use an Apex REST method:

1. On the Vlocity Cards tab, click **New** to configure a data source for a new cards component, or select an existing component to configure its data source.
2. In the Cards Designer, in the Layout or Cards pane, from the **Data Source** picklist, select **Apex REST**.
3. In the **Endpoint** field, enter the URL of the REST endpoint.
4. Specify the REST method:
    
    - `GET`—Requests data specified by the parameters of the URL.
    - `POST`—Sends JSON data specified in the Body text area.
        
        ![image](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/screenshot___rest___post.png)
    
    You can use Context Variables to pass inherited values with either method.
5. (Optional). Enter values for these properties:
    
    - To drill down to a specific dataset, in the **Result JSON Path** field, enter a path. For example, enter records.results, which drills down to the `results` array and passes the array to the card or card layout.
    - To sort data by a specific data field, enter the field name in the **Order By** input field.
    - To reverse the order of the data returned, select **True** from the **Reverse Order** picklist.
        
        ![image](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/orderbyreverseorder.png)
    - Set a **Timeout** value in milliseconds.
        
        The timeout value controls the time that the framework waits for the designated data source to return a response. Timeouts improve handling user interactions with long running processes. Setting an appropriate timeout value allows the application and users to react accordingly to long wait times.
    - Set an **Interval** value in milliseconds.
        
        The card component's data source refreshes continuously at the given interval and checks for changes in data source records. If changes are found, the layout or card component reloads. Setting an interval enables recursive updates of records.
6. To preview a card using real data, add a test variable in the **Test Data Source Settings** fields. See [Testing Data Source Settings (Managed Package)](https://help.salesforce.com/s/articleView?id=xcloud.os_testing_data_source_settings.htm&release=264.0.0&type=5 "For the managed package runtime, add runtime variables to fetch and test your data source.").