Skip to main content

Create with a Runlayer Agent

Ask the agent for a file and explicitly ask it to publish a shareable link. Include the format, audience, and information the artifact should contain.
1

Describe the result

For example: “Build a self-contained HTML dashboard from this CSV. Include filters and a summary chart. Publish it as an artifact and give me the link.”
2

Review the published file

Open the link in the agent’s response. You can also find the file in the agent’s Artifacts tab or the main Artifacts library.
3

Revise and share

Ask for changes to the existing artifact, then review its sharing settings before sending the link to colleagues.
Artifact publishing is enabled by default for new agents. If publishing is unavailable, ask the agent owner to check the agent’s settings.

How agent publishing works

The agent creates a file in its workspace and uses these built-in tools: For a visual result, ask the agent to inspect a screenshot before publishing. Choose inline for a browser preview or attachment for a download-only file. The agent can set the content type, such as text/html or application/pdf, to match the file.

Update an agent artifact

Continue with the same agent and provide the existing artifact link:
Update this report with the latest numbers. Keep the same artifact URL rather than creating a separate report: [paste the artifact link].
The agent passes the existing artifact_id to publish_artifact. This publishes a new version at the same URL. Updating this way requires the same originating agent and the same user who created the artifact. Each published file can be up to 10 MB.

Create from a connected assistant

With Runlayer MCP connected to your assistant, you can publish a standalone artifact without creating a Runlayer Agent. Your account needs Use Agents or Manage Agents access. For example:
Save this analysis as a Markdown artifact in Runlayer and give me its link.
The assistant uses create_artifact with the filename and content. Text files use content_format="text"; binary files use content_format="base64". For HTML or Markdown, specify content_type="text/html" or content_type="text/markdown"; text input otherwise defaults to plain text. Creation requires confirmation through the tool’s confirm=true parameter. Standalone artifacts appear in Created by me. Use Share on the artifact to grant colleagues access.

Read and revise standalone artifacts

Updates and text edits require confirm=true, preserve the artifact link, and create a new version. These MCP editing tools work on standalone artifacts; revise an agent-created artifact through its originating agent. See version history to review or restore an earlier result.