web
You’re offline. This is a read only version of the page.
close
Skip to main content

Announcements

News and Announcements icon
Community site session details

Community site session details

Session Id :
Copilot Studio
Suggested Answer

App Builder

(0) ShareShare
ReportReport
Posted on by

We understand that App Builder applications are represented in Power Platform as appBuilderApp resources and that the Power Platform Admin API can return properties including appUris.documentUri.

Can you confirm whether, for an appBuilderApp, there is a supported API or administrative mechanism to retrieve the complete application artifact behind that resource — including the UI definition, application structure, data schema, actions/logic, and other information required to reconstruct the prototype?

Specifically:

  1. Does properties.appUris.documentUri provide access to a downloadable or serialized App Builder artifact?
  2. If so, is consuming that artifact from an external platform a supported integration scenario?
  3. Is the artifact format documented/versioned and suitable for programmatic ingestion?
  4. If documentUri is not intended for this purpose, is there another supported API for exporting or retrieving the complete App Builder prototype?
  5. If this capability is not currently available, is it on the App Builder roadmap?
  • Suggested answer
    Mohsin Ali Profile Picture
    1,073 on at
    Hello @CU10091842-0 - I believe what you’re looking for is a supported way to export the complete App Builder app definition and then consume that definition in another platform.
     
    From what I can see, appBuilderApp is exposed through the Power Platform inventory APIs, but the documented APIs are mainly for inventory and governance metadata. I haven’t found any Microsoft documentation that treats documentUri as a supported export contract for retrieving the full app structure, logic, controls, or data model.
     
    So I would be cautious about depending on documentUri for reconstruction, even if you are able to access something behind it, because the format may be internal and could change.
     
    At the moment, I don’t think there is a documented equivalent of exporting an App Builder app as a portable package or machine-readable definition for third-party ingestion. If that is the requirement, it may be worth raising it as a product feature request or confirming with Microsoft whether an export API is planned.
     

  • Suggested answer
    M Bilal Khan Profile Picture
    376 on at
    Hi @CU10091842-0,

    I would be careful not to treat appUris.documentUri as an App Builder export API.

    The current Power Platform inventory documentation does identify App Builder apps as:

    type = microsoft.powerapps/apps
    properties.subType = appBuilderApp
    

    and exposes inventory metadata such as owner, environment, created/modified information, and quarantine state. However, the documented App Builder resource schema does not describe an API that returns the complete prototype definition, UI structure, data model, actions/logic, etc.

    So I would distinguish the two concepts:

    Power Platform Admin / Inventory API
            ↓
    App Builder resource metadata
            ↓
    appBuilderApp
            ↓
    ID, owner, environment, timestamps, status...
    

    versus:

    App Builder prototype artifact
            ↓
    UI definition
    data schema
    actions / logic
    configuration
    other reconstruction metadata
    

    The latter is not currently documented as a supported export/import contract.

    In particular, I would not assume that:

    properties.appUris.documentUri
    

    is a downloadable, versioned App Builder source artifact simply because it is exposed as a URI. Unless Microsoft explicitly documents that URI as an artifact/export endpoint, consuming it from an external system would be relying on an internal implementation detail.

    That also means I wouldn't build an integration around parsing whatever content happens to be returned from documentUri. There is currently no documented schema/versioning contract that would make that a safe programmatic ingestion mechanism.

    For the questions in the post, my interpretation would therefore be:

    1. Does documentUri provide the complete serialized App Builder app?

    There is no current Microsoft documentation establishing that it does.

    2. Is consuming it externally supported?

    I wouldn't consider it a supported integration unless Microsoft explicitly documents the URI for that purpose.

    3. Is the artifact format documented/versioned?

    I haven't found a Microsoft-published artifact schema/versioning contract for reconstructing an appBuilderApp.

    4. Is there another supported API to export the complete prototype?

    I don't see a currently documented Admin/Inventory API that provides the complete App Builder prototype source/artifact. The documented inventory API is intended for resource discovery and administration rather than source export.

    5. Roadmap?

    I would avoid stating that this is or isn't on the roadmap unless Microsoft has provided a public roadmap item specifically covering App Builder artifact export. I couldn't find a public commitment that would make that claim safe.

    If the requirement is for backup, migration, CI/CD, or external programmatic reconstruction, I'd raise this with Microsoft as a product capability request and explicitly ask:

    "Is there a supported, documented export format/API for appBuilderApp resources that can be used for programmatic backup and reconstruction?"

    That's a better question than asking specifically whether documentUri can be consumed, because it forces clarification of whether Microsoft intends the underlying artifact to be a supported integration surface.

    The important takeaway is: being able to discover an App Builder resource through the Power Platform Admin/Inventory API does not imply that its underlying design artifact is exposed as a supported export format. The current published schema supports the former, not the latter.

  • Suggested answer
    Mohsin Ali Profile Picture
    1,073 on at
    Hello @CU10091842-0 - Just wanted to follow up if the suggestions shared above really helped or pointed in right directions?
     

  • Suggested answer
    11manish Profile Picture
    4,802 Super User 2026 Season 2 on at
    appBuilderApp is now a recognized Power Platform resource, and its administrative metadata is exposed through supported APIs. However, Microsoft has not currently documented a supported mechanism to extract the complete App Builder prototype/application definition. properties.appUris.documentUri should therefore be treated as a URI property, not as a documented export/download API.

    For an enterprise solution, do not reverse-engineer documentUri and depend on its contents. Wait for/ask Microsoft for an officially supported artifact export API or documented serialization contract.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Season of Sharing Community Challenge Winners!

Congratulations to our community stars!

Kudos to our 2025 Community Spotlight Honorees

Expanding mentorship, skilling, and AI innovation

Leaderboard > Copilot Studio

#1
Mohsin Ali Profile Picture

Mohsin Ali 360

#2
Valantis Profile Picture

Valantis 253 Super User 2026 Season 2

#3
11manish Profile Picture

11manish 184 Super User 2026 Season 2

Last 30 days Overall leaderboard