---
title: "List Try-Me Configs."
method: GET
path: "/dojo/try-me-configs"
tags: ["Dojo"]
---

# List Try-Me Configs.

`GET /dojo/try-me-configs`

## Request

- Base URL: `https://api.mnemom.ai/v1`
- URL: `https://api.mnemom.ai/v1/dojo/try-me-configs`
- Auth: HTTP bearer

Lists Try-Me Configs newest-first. Filter by `?token=` (collision check) and `?live=true` (only un-burned, un-expired). Admin-only. MNE-517 §3 / MNE-522.

## Query parameters

- `token` string
- `live` boolean

## Response `200`

The matching Try-Me Configs.

- object
  - `configs` object[], required
    - `id` string, uuid, required
    - `token` string, required: The single-use resolve credential. MNE-828: server-generated, high-entropy, prefixed `tryme_…` (no longer a user-chosen slug). Existing low-entropy tokens keep resolving (back-compat).
    - `label` string, nullable: MNE-828: optional operator label (free text) for the operator's own list. NOT a credential and never resolved against.
    - `scenario_id` string, required
    - `model_provider` 'anthropic' | 'openai' | 'google', required
    - `model_name` string, required
    - `compute_key_ref` string, nullable: mnemom_api_keys.key_id of the bound compute key.
    - `briefing_manifest_ref` string, nullable
    - `logo_url` string, uri, nullable: MNE-1322: optional brand logo (https URL) attached to the invite; the agent minted from it carries this as its avatar.
    - `usage_limit` integer, required
    - `uses_remaining` integer, required: Burns to 0 on first use.
    - `used_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `self_serve_resettable` boolean: When true, the anon self-serve reset (POST /dojo/try-me/reset) may re-arm this token. Default false (opt-in).
    - `reset_count` integer: Monotonic self-serve reset count, capped in-handler to bound farmed births.
    - `created_by` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate-limit exceeded. The global per-IP limiter (100 requests/minute, applied to every `/v1/*` route) rejected this request. Back off until the window resets — `Retry-After` carries the cooldown in seconds and `X-RateLimit-Reset` the absolute reset time.
- `500`: Server error — request was well-formed but the server failed to fulfill it. Typically a downstream dependency (DB / RPC / external API) returned an unexpected error.

---

[API](https://skmtc.dev/mnemom/apis/mnemom-api.md) · [All operations](https://skmtc.dev/mnemom/apis/mnemom-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mnemom/apis/mnemom-api/revisions/e13923bd55ef?raw)