> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slng.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Download configuration

> Download a managed agent's saved configuration as JSON, from the dashboard or the API.

You can download a managed agent's saved configuration as a JSON file, from the
dashboard or the API. The file holds the agent's full config, including its name,
prompt, greeting, language, region, models, idle nudges, and tool and MCP
references, so you can back it up, review changes, or re-apply it with the API.
It reflects the last saved configuration and leaves out secrets and call
credentials.

## Prerequisites

* A managed agent that runs on SLNG. If you do not have one, see
  [Create an agent](/guides/get-started/create-a-project/create-agent).
* For the API path, an API key. See
  [Create your API key](/guides/get-started/quickstart#create-your-api-key).

## Download the configuration

<Tabs>
  <Tab title="Dashboard" icon="monitor">
    Open the project, click the **⋯** menu in the top right, and choose
    **Download configuration**. The browser saves the agent's config as
    `agent-<id>.json`.

    The file always holds the last **saved** configuration, so save any pending
    edits first if you want them included.

    <Frame caption="The project's ⋯ menu, with Download configuration.">
      <img src="https://mintcdn.com/slng-new-docs/fgzHSTXC7k7AhIuF/images/placeholder-screenshot.svg?fit=max&auto=format&n=fgzHSTXC7k7AhIuF&q=85&s=01f318046002e0b0937cc88f63eba566" alt="The project workspace ⋯ menu with the Download configuration item" width="1200" height="675" data-path="images/placeholder-screenshot.svg" />
    </Frame>
  </Tab>

  <Tab title="API" icon="code">
    Request the agent's config. The response is the JSON file, named from the
    `Content-Disposition` header.

    ```bash Request theme={null}
    curl -OJ https://api.agents.slng.ai/v1/agents/$AGENT_ID/config \
      -H "Authorization: Bearer $SLNG_API_KEY"
    ```

    `-OJ` saves the file with the server's name (`agent-<id>.json`). Drop it to
    print the JSON to the terminal instead.

    To download a specific saved version, add its number:

    ```bash Request theme={null}
    curl -OJ https://api.agents.slng.ai/v1/agents/$AGENT_ID/versions/$VERSION/config \
      -H "Authorization: Bearer $SLNG_API_KEY"
    ```
  </Tab>
</Tabs>

## What the file contains

The download is the agent's full configuration, the same object the API returns
when you [create or read an agent](/guides/get-started/create-a-project/create-agent):
its name, `system_prompt`, `greeting`, `language`, `region`, the `models` block,
`idle_nudges`, and its tool and MCP references.

It leaves out secret values, such as tool or webhook secrets, and the temporary
credentials from a call or test session. Those stay server-side.

## Re-apply a configuration

Use a downloaded file as the body of a full update, then send it back with `PUT`
to replace the agent's configuration in one request. See
[Update an agent](/guides/get-started/create-a-project/create-agent#update-an-agent).

<Note>
  Download configuration is available for agents that run on SLNG. A project that
  improves an agent in your own code has no managed agent to download.
</Note>

## Next steps

* [Update an agent](/guides/get-started/create-a-project/create-agent#update-an-agent)
  to re-apply a saved configuration with `PUT`.
* [Agent behavior](/guides/agents/configure/agent-behavior) and the Listen,
  Think, and Speak sections to change what the configuration contains.
