---
title: "Retrieve hosting configuration"
method: GET
path: "/v1/namespace/{namespaceId}/hosting"
tags: ["Hosting"]
---

# Retrieve hosting configuration

`GET /v1/namespace/{namespaceId}/hosting`

Retrieve the hosting configuration for a namespace.

## Path parameters

- `namespaceId` string, required — The id of the namespace (prefixed with ns_)

## Response `200`

The hosting configuration

- object
  - `success` true, required
  - `data` Hosting, required
    - `namespaceId` string, required — The ID of the namespace this hosting belongs to.
    - `title` string, nullable, required — The title displayed on the hosted interface.
    - `slug` string, nullable, required — The unique slug for accessing the hosted interface.
    - `logo` string, nullable, required — The URL or base64 encoded image of the logo.
    - `ogTitle` string, nullable, required — Custom Open Graph title for social media sharing.
    - `ogDescription` string, nullable, required — Custom Open Graph description for social media sharing.
    - `ogImage` string, nullable, required — Custom Open Graph image URL for social media sharing.
    - `systemPrompt` string, nullable, required — Custom instructions layered on top of Agentset's retrieval and citation rules. `null` means the chat uses Agentset's default prompt.
    - `exampleQuestions` string[], required — Example questions to display to users in the chat interface.
    - `exampleSearchQueries` string[], required — Example search queries to display to users in the search interface.
    - `welcomeMessage` string, nullable, required — Welcome message displayed to users.
    - `citationMetadataPath` string, nullable, required — Path to metadata field used for citations.
    - `searchEnabled` boolean, required — Whether search functionality is enabled.
    - `rerankConfig` unknown, required
    - `llmConfig` unknown, required
    - `topK` integer, required — Number of documents to retrieve from vector store.
    - `protected` boolean, required — Whether the hosted interface is protected by authentication.
    - `allowedEmails` string[], required — List of allowed email addresses (when protected is true).
    - `allowedEmailDomains` string[], required — List of allowed email domains (when protected is true).
    - `createdAt` string, required — The date and time the hosting was created.
    - `updatedAt` string, required — The date and time the hosting was last updated.

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).
- `401` — Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response.
- `403` — The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server.
- `404` — The server cannot find the requested resource.
- `409` — This response is sent when a request conflicts with the current state of the server.
- `410` — This response is sent when the requested content has been permanently deleted from server, with no forwarding address.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.
- `429` — The user has sent too many requests in a given amount of time ("rate limiting")
- `500` — The server has encountered a situation it does not know how to handle.

---

[API](https://skmtc.dev/agentset/apis/agentsetapi.md) · [All operations](https://skmtc.dev/agentset/apis/agentsetapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agentset/agentsetapi/revisions/cc6ac802092e/schema)