Features - User Config Read

Endpoint

/o/userconfigs

Overview

Returns user-level configuration values for the authenticated dashboard user.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

Requires an authenticated dashboard user.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Examples

Read current user config

/o/userconfigs?api_key=YOUR_API_KEY

Response

Success Response

{
  "frontend": {
    "session_timeout": 15
  }
}

Response Fields

Field	Type	Description
(root)	Object	User-level configuration map.
{namespace}	Object	Namespace-level user configuration.
{namespace}.{setting}	Varies	Effective user-level setting value.

Error Responses

• 400

{
  "result": "Missing parameter \"api_key\" or \"auth_token\""
}

• 400

{
  "result": "Token not valid"
}

• 401

{
  "result": "User does not exist"
}

• 401

{
  "result": "User is locked"
}

• 401

{
  "result": "Token is invalid"
}

• 401

{
  "result": "User does not have right"
}

Behavior

Behavior Modes

Mode	Condition	Result
User config read	Authenticated user validation passes	Returns user-level config map from member settings context.

Impact on Other Data

This endpoint is read-only and does not modify data.

Related Endpoints

• Features - User Config Update
• Features - Global Config Read

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.members	Authentication and user settings lookup	Reads authenticated user and uses member.settings to build user config response.