Config API

Manage Claude Code configuration across all scopes.

Endpoints

List Config Files

GET /api/v1/config/files?project_path={path}

Returns all configuration file paths with their existence status.

Get Merged Config

GET /api/v1/config?project_path={path}

Returns the merged configuration from all scopes. This is the effective configuration that Claude Code uses.

Response:

{
  "settings": { ... },
  "mcp_servers": { ... },
  "hooks": { ... },
  "permissions": { ... },
  "commands": [ ... ],
  "agents": [ ... ]
}

Get Raw File Content

GET /api/v1/config/raw?path={file_path}&project_path={path}

Returns the raw content of a specific configuration file.

Get Settings by Scope

GET /api/v1/config/settings/{scope}?project_path={path}

scope: user or project

Get Resolved Config

GET /api/v1/config/resolved?project_path={path}

Returns resolved settings with the effective value and source scope for each key.

Get All Scopes

GET /api/v1/config/scopes?project_path={path}

Returns settings from all scopes (managed, user, project, local) without merging.

Update Settings

PUT /api/v1/config/settings

Request Body:

{
  "scope": "user",
  "settings": { "model": "claude-sonnet-4-6" },
  "project_path": "/path/to/project"
}

Validate Settings

POST /api/v1/config/validate-settings

Validates permission patterns without saving.

Request Body:

{
  "settings": { "permissions": { "allow": ["Bash(npm run *)"] } }
}