---
title: "Set Namespace Instance Config"
method: PUT
path: "/v1/namespace/{namespace_id}/instance"
tags: ["v1", "Instance Configuration"]
---

# Set Namespace Instance Config

`PUT /v1/namespace/{namespace_id}/instance`

Set dedicated instance configuration for a namespace.

## Path parameters

- `namespace_id` string, required

## Query parameters

- `validate` boolean — Test connection before saving

## Headers

- `X-API-Key` string, required

## Request body

- InstanceConfigInput — Request body for setting instance configuration.
  - `neo4j` Neo4jInstanceConfigInput — Neo4j AuraDB instance configuration — input (plain password).
    - `bolt_url` string, required — Neo4j bolt connection URL (e.g. 'neo4j+s://xxxxx.databases.neo4j.io')
    - `username` string — Neo4j username
    - `password` string, required — Neo4j password (encrypted before storage)
    - `graphql_endpoint` string, nullable — Neo4j hosted GraphQL endpoint URL (e.g. 'https://xxxxx-graphql.production-orch-xxxx.neo4j.io/graphql')
  - `provider` string — Cloud provider (only 'gcp' supported today)
  - `region` string — Cloud region (only 'us-west1' supported today)

## Response `200`

Successful Response

- InstanceConfigResponse — Standard response envelope for instance config operations.
  - `code` integer — HTTP status code
  - `status` string — 'success' or 'error'
  - `data` InstanceConfigItem — Instance configuration — response model for GET endpoints.
    - `neo4j` Neo4jInstanceConfigItem — Neo4j instance configuration — response (password masked).
      - `bolt_url` string, required — Neo4j bolt connection URL
      - `username` string, required — Neo4j username
      - `password_masked` string, required — Masked password (e.g. '****ab12')
      - `graphql_endpoint` string, nullable — Neo4j GraphQL endpoint URL
    - `provider` string, required — Cloud provider
    - `region` string, required — Cloud region
    - `scope` string, required — Where this config was resolved from: 'namespace' or 'organization'
  - `error` string, nullable — Error message if failed
  - `details` unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.net/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/papr-ai/papr-memory-api/versions/b553be9aad37/schema)