How do I fetch raw prompt text that contains references to other prompts?

[mturzynski-xelerit]

Hi,

I’m developing a script that synchronizes prompts between Langfuse projects using the Python SDK. My system relies on prompt references - that is, prompts built from other Langfuse prompts, as described in your composability documentation.

When I fetch a prompt using either the Python SDK or the REST API, the prompt text I receive is already resolved. This makes it unsuitable as a source for synchronization, since I need the original (unresolved) prompt text.

Is there a way to access the raw, unresolved prompt text through the SDK or API?

Thanks,
Mateusz

[inkeep-ai-assistant[bot]]

Based on the available documentation, when you fetch prompts via the SDK or API, Langfuse automatically resolves prompt references before returning the content(1). The documentation does not describe a method to retrieve the raw, unresolved prompt text that contains the reference tags (like @@@langfusePrompt:name=PromptName|version=1@@@)(1).

The prompt composability feature is designed so that "when fetched via the SDK / API, these tags are automatically replaced with the referenced prompt content"(2). This automatic resolution happens at fetch time and appears to be the standard behavior across both the Python SDK and the REST API(1)(3)(2).

For your synchronization use case, where you need the original unresolved prompt text, this automatic resolution creates a challenge. The documentation doesn't mention a parameter or flag to disable this resolution behavior when fetching prompts.

I'd recommend checking out these potentially helpful resources:

• Prompt Composability
• Get Started with Prompt Management
• Troubleshooting and FAQ

Would you like me to provide a general answer based on my broader knowledge of how similar systems typically handle this?

📚 Sources:

1. Prompt Composability
2. Prompt Composability - Langfuse
3. Get Started with Prompt Management

---

Have another question? Just tag @inkeep.

[jannikmaierhoefer]

Hi @mturzynski-xelerit, this is currently on our roadmap - we are tracking this here: https://github.com/orgs/langfuse/discussions/9546

[mturzynski-xelerit]

@jannikmaierhoefer is there any workaround I could use? I need to keep in sync prompts between the dev and prod projects. I manage them manually now, but it's super time consuming for dozens of prompts. Created a sync tool, but I can't really use it, since I can't fetch a raw prompt through either SDK or API. I'd appreciate any suggestions.

[jannikmaierhoefer]

@mturzynski-xelerit, unfortunately, we currently dont have a workaround for this. I'll discuss this with the team for our Q1 roadmap planning.

[jannikmaierhoefer]

Hi all, we have shipped this, you can now pass a resolve query param to your v2 Prompts API call: https://api.reference.langfuse.com/#tag/prompts/GET/api/public/v2/prompts/{promptName}