Programatic shortcut creation in Lakehouse, using Fabric API.

[ElektroHulk]

Good day, 

Just a note, I did reply to a topic that had a relatively similar Subject, however it was old and I thought I would create a new Post, as I am not sure how often old topics are checked by the moderators of the forum. 

I have attempted to programatically perform a shortcut creation in a Lakehouse, that will point to a Dataverse entity in a Fabric Notebook using the Fabric API, however I can not make it work. 
Therefore, my question is, has the support for shortcut creation has already been added to the API or not yet? 

Just in case, I will add some context to my case. I have created a 'Link to Microsoft Fabric' from my Dataverse environment to a Lakehouse in Fabric. I have removed 1-2 tables in Fabric, thus removing the shortcuts. I want now to add the shortcuts back, but I need to do it programatically. 
This is the code that I am using to call the API:

entity = 'actioncard'
DATAVERSE_END_URL = 'https://myorgxxx.crm4.dynamics.com'

url = f"https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/items/{LAKEHOUSE_ID}/shortcuts"

headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

# create shortcuts for a list of entities
for entity in MISSING_ENTITIES:
    print(entity)
    payload = {
        "name": entity,
        "path": f"Tables/{entity}",
        "target": {
            "dataverse" : {
                "deltaLakeFolder": "",
                "environmentDomain": DATAVERSE_END_URL,
                "tableName": f"{entity}",
                "connectionId": CONNECTION_ID
            }
        }
    }

    try:
        response = requests.post(url, headers=headers, json=payload)

I am getting the following 400 error:

Failed to create actioncard: 400 - {"requestId":"1534w4aa-e00a-4f05-aa9f-d4c5573456c9","errorCode":"BadRequest","moreDetails":[{"errorCode":"RequestBodyValidationFailed","message":"Shortcut target uri /actioncard:Dataverse is malformed."}],"message":"The request could not be processed due to missing or invalid information"}

If the support has been implemented but I am taking the wrong approach, please reffer to the correct documentation. 

Thanks a lot in advance.

[ElektroHulk]

Good day, guys. 

@v-saisrao-msft @nilendraFabric 

Unfortunately, I was on medical leave starting Thursday last week and did not have a chance to try this. I will do so today or tomorrow and will most definitely come back with updates and feedback. 

[ElektroHulk]

Good day, @v-saisrao-msft  and @nilendraFabric .
Thank you very much for taking the time to help with some good advice and pointers/hints. 
I will go through both your recommendations and will let you know the output afterwards. 

[v-saisrao-msft]

Hi @ElektroHulk,

May I ask if you have resolved this issue? If so, please mark the helpful reply and accept it as the solution. This will be helpful for other community members who have similar problems to solve it faster.

Thank you.

[v-saisrao-msft]

Hi @ElektroHulk,

Just checking in  have you had a chance to go through the suggestions we shared us?

Thank you.

[nilendraFabric]

Hello @ElektroHulk 

try this code

entity = 'actioncard'
DATAVERSE_END_URL = 'https://myorgxxx.crm4.dynamics.com'

url = f"https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/items/{LAKEHOUSE_ID}/shortcuts"

headers = {
"Authorization": f"Bearer {token}",
"Content-Type": "application/json"
}

# Create shortcuts for a list of entities
for entity in MISSING_ENTITIES:
print(entity)
payload = {
"path": "Tables",
"name": entity,
"target": {
"type": "Dataverse",
"dataverse": {
"environmentUrl": DATAVERSE_END_URL,
"tableName": entity,
"connectionId": CONNECTION_ID
}
}
}

try:
response = requests.post(url, headers=headers, json=payload)

[ElektroHulk]

hi @nilendraFabric 
Your solution did not work, unfortunately. 

It still asks for the "deltaLakeFolder" property and value. If I add the deltaLakeFolder property it is telling me it's malformed. 

As far as I understand, the "deltaLakeFolder" would be useful only when creating the Link via Synapse, as it stores the entities as parquet delta tables in a an ADLS. But for "Link to Microsoft Fabric", such property might not be of much use, the 'ghost' copy of the Dataverse that is created when using this Link option is stored on Dataverse storage. 

Maybe I am wrong. 

[v-saisrao-msft]

Hi @ElektroHulk,
Thank you for reaching out to the Microsoft Fabric Forum Community. 

According to the official Microsoft documentation, creating shortcuts to Dataverse tables is supported via the Fabric REST API. However, it’s a relatively new capability, and some behaviors may still differ slightly from shortcuts created via the Fabric UI (e.g., through Power Apps or the Power Platform Admin Center). 
The error you're encountering: 

"Shortcut target uri /actioncard:Dataverse is malformed." 
 suggests there might be a structural issue in the request body — either a missing required field or a mismatch in expected values. 

Here are a few areas to review while troubleshooting: 

• Ensure all required fields in the request body are populated correctly — for Dataverse, this typically includes environmentDomain, tableName, connectionId, and deltaLakeFolder. 
• Validate that the connectionId being used is correct and linked to the Dataverse connection established via the Fabric UI. 
• Make sure that tableName and environmentDomain match the exact values in your Dataverse setup, as the API can be sensitive to formatting and casing. 
• Avoid leaving optional fields blank if the API still expects a value (e.g., deltaLakeFolder). 

Please refer the below documents for your reference: 
OneLake Shortcuts - Create Shortcut - REST API (Core) | Microsoft Learn 
Unify data sources with OneLake shortcuts - Microsoft Fabric | Microsoft Learn

If this post helps, then please give us ‘Kudos’ and consider Accept it as a solution to help the other members find it more quickly. 

 
Thank you.