---
title: "Get the org's signup-time suggested namespace"
method: GET
path: "/v1/onboarding/suggested-config"
tags: ["Onboarding"]
---

# Get the org's signup-time suggested namespace

`GET /v1/onboarding/suggested-config`

## Request

- Base URL: `https://api.mixpeek.com`
- URL: `https://api.mixpeek.com/v1/onboarding/suggested-config`
- Auth: HTTP bearer

Returns the namespace configuration that was suggested from Mixpeek's company research at signup, if one was provisioned. Studio uses this to badge the suggested namespace.

## Response `200`

Successful Response

- SuggestedConfigResponse: The org's signup-time suggested namespace, if one was provisioned. Studio uses this to badge the suggested namespace with a "suggested from our research" indicator. ``exists`` is False when the signup was skipped (personal domain, no enrichment signal, feature disabled) or the org predates the feature; ``manifest_applied`` is False when a suggestion was generated but provisioning failed — show no indicator in either case.
  - `exists` boolean, required: Whether a suggestion record exists for this org.
  - `namespace_name` string, nullable: Name of the suggested (and provisioned) namespace.
  - `rationale` string, nullable: One-sentence, user-facing reason this setup was suggested.
  - `manifest_applied` boolean: True only if the suggested namespace was actually provisioned.
  - `applied_at` string, date-time, nullable
  - `sample_queries` string[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-09** `61a175e8eb9a`: 1 warning, 5 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
  - added the optional property `success` to the response with the `422` status
  - …2 more
- **2026-08-09** `5d4c905106b4`: 1 info
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-07** `fc4cabb40880`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/onboarding/suggested-config/get.md)

---

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