Users

Operations for managing users

Get groups matching the given filters.

get

Required Roles: ApiUsers

Authorizations
Query parameters
namestringOptional

Filter groups whose name contains a specific string.

rolestring · enumOptional

Filter groups with specific role.

Possible values:
Responses
200

OK

application/json
get
GET /fact-finder//rest/v5/groups HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

[
  {
    "name": "text",
    "roles": [
      "AbTestManager"
    ]
  }
]

Create a new group. Non-admin user are not allowed to create groups containing api roles.

post

Required Roles: ApiUsers

Authorizations
Body
namestringRequired

The name of the group.

Responses
200

OK

application/json
post
POST /fact-finder//rest/v5/groups HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "name": "text",
  "roles": [
    "AbTestManager"
  ]
}
{
  "name": "text",
  "roles": [
    "AbTestManager"
  ]
}

Update group. Non-admin user are not allowed to add new api roles to the group.

put

Required Roles: ApiUsers

Authorizations
Body
namestringRequired

The name of the group.

Responses
200

OK

application/json
put
PUT /fact-finder//rest/v5/groups HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "name": "text",
  "roles": [
    "AbTestManager"
  ]
}
{
  "name": "text",
  "roles": [
    "AbTestManager"
  ]
}

Delete multiple groups.

delete

Required Roles: ApiUsers

Authorizations
Query parameters
namestring[]Required

List with names of the groups that should be deleted.

Responses
200

OK

application/json
delete
DELETE /fact-finder//rest/v5/groups HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

[
  {
    "name": "text",
    "roles": [
      "AbTestManager"
    ]
  }
]

Delete the group with the given name.

delete

Required Roles: ApiUsers

Authorizations
Path parameters
namestringRequired

Name of the group which should be deleted.

Responses
200

OK

application/json
delete
DELETE /fact-finder//rest/v5/groups/{name} HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

{
  "name": "text",
  "roles": [
    "AbTestManager"
  ]
}

Get visible channels

get

Required Roles: none

Authorizations
Responses
200

OK

application/json
Responsestring[]
get
GET /fact-finder//rest/v5/user/channel HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

[
  "text"
]

Get the users, which fulfil the given filters.

get

Required Roles: ApiUsers

Authorizations
Query parameters
channelstringOptional

Filter users assigned a specific channel.

groupstringOptional

Filter users who are part of a specific group.

namestringOptional

Filter users whose name contains a specific string.

rolestring · enumOptional

Filter users with a specific role.

Possible values:
Responses
200

OK

application/json
get
GET /fact-finder//rest/v5/users HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

[
  {
    "lastActive": "2025-08-15T13:49:36.898Z",
    "name": "text",
    "origin": "LOCAL",
    "permissions": {
      "allowAllCurrentAndFutureChannels": true,
      "channels": [
        "text"
      ],
      "groups": [
        "text"
      ],
      "roles": [
        "AbTestManager"
      ]
    },
    "uiSettings": {
      "enableAdvancedMode": true,
      "hideErrorNotifications": true,
      "hideInactiveModules": true,
      "locale": "text"
    }
  }
]

Create a new local user. Non-admin user are not allowed to create user with api roles or admin user. Only channels known by the creating user can be added to the new user.

post

Required Roles: ApiUsers

Authorizations
Body

Represents a user, which should be created, and its settings.

namestring · min: 1 · max: 100Required

The name of the user.

passwordstringRequired

The password of the user in plaintext.

ssoEnabledbooleanOptional
Responses
200

OK

application/json
post
POST /fact-finder//rest/v5/users HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 285

{
  "name": "text",
  "password": "text",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "ssoEnabled": true,
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}
{
  "lastActive": "2025-08-15T13:49:36.898Z",
  "name": "text",
  "origin": "LOCAL",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}

Update user ui settings and permissions. Non-admin user are not allowed to add api roles or channels unknown to the creating user. Use dedicated api, if you want to change the password.

put

Required Roles: ApiUsers

Authorizations
Body

Represents a user, which should be updated, and its settings.

namestringRequired

The name of the user.

Responses
200

OK

application/json
put
PUT /fact-finder//rest/v5/users HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 249

{
  "name": "text",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}
{
  "lastActive": "2025-08-15T13:49:36.898Z",
  "name": "text",
  "origin": "LOCAL",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}

Delete multiple users.

delete

Required Roles: ApiUsers

Authorizations
Query parameters
namestring[]Required

The names of users that will be deleted.

Responses
200

OK

application/json
delete
DELETE /fact-finder//rest/v5/users HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

[
  {
    "lastActive": "2025-08-15T13:49:36.898Z",
    "name": "text",
    "origin": "LOCAL",
    "permissions": {
      "allowAllCurrentAndFutureChannels": true,
      "channels": [
        "text"
      ],
      "groups": [
        "text"
      ],
      "roles": [
        "AbTestManager"
      ]
    },
    "uiSettings": {
      "enableAdvancedMode": true,
      "hideErrorNotifications": true,
      "hideInactiveModules": true,
      "locale": "text"
    }
  }
]

Delete user.

delete

Required Roles: ApiUsers

Authorizations
Path parameters
userNamestringRequired

The name of user that will be deleted.

Responses
200

OK

application/json
delete
DELETE /fact-finder//rest/v5/users/{userName} HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Accept: */*

{
  "lastActive": "2025-08-15T13:49:36.898Z",
  "name": "text",
  "origin": "LOCAL",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}

Update user password. The password is expected to be plain text. Only passwords for local users can be changed.

put

Required Roles: ApiUsers

Authorizations
Path parameters
userNamestringRequired

The name of the user, whose password should be changed.

Body
stringOptional

The password

Responses
200

OK

application/json
put
PUT /fact-finder//rest/v5/users/{userName}/password HTTP/1.1
Host: ng-demo.fact-finder.de
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"
{
  "lastActive": "2025-08-15T13:49:36.898Z",
  "name": "text",
  "origin": "LOCAL",
  "permissions": {
    "allowAllCurrentAndFutureChannels": true,
    "channels": [
      "text"
    ],
    "groups": [
      "text"
    ],
    "roles": [
      "AbTestManager"
    ]
  },
  "uiSettings": {
    "enableAdvancedMode": true,
    "hideErrorNotifications": true,
    "hideInactiveModules": true,
    "locale": "text"
  }
}
PreviousTrackingNextModels

Was this helpful?