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

# Manage Loop threads and limits

> Copy, export, share, rename, and delete threads, understand sandbox lifecycle, and learn how Loop limits concurrent active threads.

Loop saves your threads so you can return to work in progress, share investigations, or export results.

## View thread history

Long threads load recent history first. After Loop finishes working, scroll to the top and click **Load earlier messages** when available.

## Copy or export a thread

A Markdown transcript lets you share an investigation outside Braintrust or hand it to a coding agent. It includes messages, context names, Loop's responses, and tool calls with their arguments, outputs, and errors. Attached files appear as a count and aren't embedded.

Before copying or exporting, click [**Load earlier messages**](#view-thread-history) until it no longer appears. The transcript includes only loaded messages.

* **Copy to the clipboard**: Click  **Copy as Markdown** in the thread header. In narrow layouts and in Loop chats opened from other pages, the button shows only its icon.
* **Download a file**: On the [** Loop**](https://www.braintrust.dev/app/~/loop) page, select  in the thread header, then  **Export conversation** to download the transcript as a `.md` file. Only the thread owner can export a thread.

## Share a thread

Threads are private by default. Share a thread you own so project members can review the entire conversation or continue the investigation.

* Loop accesses Braintrust using each message sender's permissions.
* Only the sender can approve or cancel work started by their message.
* Only the owner can edit messages, and only their own.

1. Go to [** Loop**](https://www.braintrust.dev/app/~/loop) and select your thread.
2. Click **Share** in the thread header.
3. Choose an access level:
   * **Members can view** lets members with project read access view the conversation.
   * **Members can chat** also lets members who can create Loop threads send messages.
4. Click **Save** to apply the access level and copy the thread link. To copy the link again, reopen **Share** and click **Copy Link**.

Only the owner can change access. Reopen **Share**, choose an access level or **Private to you**, and click **Save**.

> [!WARNING]
>
> Before making a thread private or removing chat access, have participants finish or cancel their work. Changing access leaves their queued or running turns in progress but prevents them from approving actions or canceling those turns.

## Rename a thread

Only the thread owner can rename a thread.

1. On the [** Loop**](https://www.braintrust.dev/app/~/loop) page, select  in the thread header or beside a thread in the sidebar, then  **Rename thread**.
2. Enter a name of up to 256 characters and click **Save**.

## Delete a thread

Only the owner can delete a thread, and only while Loop isn't working in it. A sleeping sandbox doesn't prevent deletion. Automation run threads are read-only and cannot be deleted this way. See [Review past runs](https://docs.braintrust.dev/loop/automations.md#review-past-runs).

> [!WARNING]
>
> Deleting a thread is permanent and cannot be undone.

On the [** Loop**](https://www.braintrust.dev/app/~/loop) page, select  in the thread header or beside a thread in the sidebar, then  **Delete thread** and confirm.

## Sandboxes

Loop uses an isolated, per-user sandbox to inspect trace files and run commands against your data.

* **Start.** A sandbox starts with your first message in a thread. Opening the [** Loop**](https://www.braintrust.dev/app/~/loop) page or revisiting a saved thread doesn't start one.
* **Sleep.** After inactivity, the sandbox sleeps. Your next message resumes it automatically with the thread history intact.
* **Expiry.** A sandbox lasts up to 8 hours, including time asleep. After it expires, your next message starts a fresh sandbox without affecting the thread or its history.

## Thread concurrency

Braintrust-hosted Loop limits active threads separately for each member, service token, and automation within an organization. A thread occupies a slot while Loop works and for a short idle period afterward. Further messages in that thread don't consume extra slots.

| Organization plan | Concurrent active threads |
| - | - |
| Starter without on-demand usage | 5 |
| Starter with on-demand usage, Pro, and Enterprise | 50 |

At the limit, starting work in another thread returns HTTP `429`. Wait for a slot to become available, then retry. Existing threads and histories are unaffected.

## Models and providers

For any of [Loop's models](https://docs.braintrust.dev/loop/get-started.md#choose-a-provider-and-model), choose how inference is served and billed with the model picker's **Provider** setting. Loop remembers the selected provider for each thread.

* **Braintrust.** Use Braintrust's AI providers with no setup. Usage draws from your organization's monthly [model credits](https://docs.braintrust.dev/plans-and-limits.md#model-credits), shared with Topics. On Starter, you need an organization owner with a work email address or a payment method on file. See [Requirements](https://docs.braintrust.dev/admin/ai-providers.md#requirements).
* **Your configured provider.** Use an OpenAI-compatible [AI provider](https://docs.braintrust.dev/admin/ai-providers.md) configured for your organization or the thread's project, with inference billed to that provider.

New threads start with **Auto** on, using your organization's [default provider](https://docs.braintrust.dev/admin/organizations.md#set-a-default-provider-for-loop) and its recommended model and reasoning effort. [Automations](https://docs.braintrust.dev/loop/automations.md) with **Auto** on follow the default on every run.

* **No saved default:** Braintrust is the default when built-in models are available.
* **Thread override:** Choosing another provider turns off **Auto** for that thread. New threads still start on the default.
* **Default unavailable or missing:** **Auto** is unavailable, and new threads use your most recent choice.

> [accordion] Configure your own provider
>
> 1. Open the model picker and turn off **Auto** if enabled.
> 2. Select **Configure providers** from **Provider**, or directly from the picker if no providers are available.
> 3. Choose **Custom providers** >  **New**.
>
> You can also add providers in \*\* Settings\*\* > [\*\* Models\*\*](https://www.braintrust.dev/app/~/configuration/models/organization). To require your organization's providers, turn off **Allow built-in models** there. This removes **Braintrust** from Loop's provider options.
>
> Your provider must serve a supported Loop model. Gateway prefixes and custom endpoints don't expand the model list:
>
> * **Compatibility.** Supported formats are OpenAI, Azure, Bedrock, Databricks, OpenRouter, and Azure AI Gateway. You need a configured provider once model credits run out.
> * **Model IDs.** Loop sends the model ID configured on your provider as is, including Bedrock cross-region IDs such as `us.openai.gpt-6-luna` and `global.openai.gpt-6-luna`.
> * **Databricks.** Databricks uses its own IDs for Loop's models: `databricks-` plus the model name with dots changed to hyphens, such as `databricks-gpt-6-sol` or `databricks-gpt-6-1-sol`. On a Databricks provider, Loop doesn't recognize IDs such as `gpt-6-sol` or `openai/gpt-6-sol`.
> * **DeepSeek endpoints.** DeepSeek's API serves DeepSeek models, not Loop's GPT models, so Loop doesn't offer a provider whose **API base URL** host is `api.deepseek.com`, even if its format is supported. Gateways and proxies on other hostnames aren't excluded, but they must still serve the selected Loop model.

## Privacy

Threads are private by default. You can [share a thread with project members](#share-a-thread) to grant access to its conversation history and optionally let them send messages.

Braintrust logs frontend Loop interactions for product improvement and support by default. You can [turn off logging](https://docs.braintrust.dev/admin/organizations.md#control-loop-logging) without affecting Loop. BYOC organizations have it off.

Model data handling depends on the feature:

* **Loop.** Your configured provider uses the key configured for that provider. Your agreement with that provider, including any zero data retention agreement, governs prompts and responses. See [Data handling](https://docs.braintrust.dev/admin/ai-providers.md#data-handling).

* **Automations and Patterns.** [Loop automations](https://docs.braintrust.dev/loop/automations.md) and [Patterns](https://docs.braintrust.dev/observe/patterns.md) use the model and provider saved in each automation's configuration.

* **Topics.** Facet summarization, embeddings, and cluster naming in [Topics](https://docs.braintrust.dev/observe/topics.md) always use Braintrust-served models with Zero Data Retention, regardless of your Loop model.

## Next steps

* [What Loop can do](https://docs.braintrust.dev/loop.md) for the full range of tasks.
* [Run Loop on a schedule](https://docs.braintrust.dev/loop/automations.md) for work that shouldn't depend on an open chat.
* [Plans and limits](https://docs.braintrust.dev/plans-and-limits.md) for the rest of the system limits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.