Create a User

Create a User

curl --request POST \
  --url https://api.altostrat.io/radius/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "[email protected]",
  "password": "S3cur3P@ssw0rd!",
  "status": "active",
  "groups": [
    "rad_grp_01HGM5V65A5A5A5A5A5A5A5A5B"
  ],
  "check_attributes": "<unknown>",
  "reply_attributes": "<unknown>",
  "metadata": "<unknown>"
}
'

{
  "id": "rad_usr_01HGM5V65A5A5A5A5A5A5A5A5A",
  "username": "[email protected]",
  "status": "active",
  "group_count": 2,
  "check_attributes": [
    {
      "attribute": "Session-Timeout",
      "op": ":=",
      "value": "3600"
    }
  ],
  "reply_attributes": [
    {
      "attribute": "Session-Timeout",
      "op": ":=",
      "value": "3600"
    }
  ],
  "metadata": {
    "employee_id": "E12345"
  },
  "tags": [
    "rad_tag_01HGM5V65A5A5A5A5A5A5A5A5D"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

POST

radius

users

Create a User

curl --request POST \
  --url https://api.altostrat.io/radius/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "username": "[email protected]",
  "password": "S3cur3P@ssw0rd!",
  "status": "active",
  "groups": [
    "rad_grp_01HGM5V65A5A5A5A5A5A5A5A5B"
  ],
  "check_attributes": "<unknown>",
  "reply_attributes": "<unknown>",
  "metadata": "<unknown>"
}
'

{
  "id": "rad_usr_01HGM5V65A5A5A5A5A5A5A5A5A",
  "username": "[email protected]",
  "status": "active",
  "group_count": 2,
  "check_attributes": [
    {
      "attribute": "Session-Timeout",
      "op": ":=",
      "value": "3600"
    }
  ],
  "reply_attributes": [
    {
      "attribute": "Session-Timeout",
      "op": ":=",
      "value": "3600"
    }
  ],
  "metadata": {
    "employee_id": "E12345"
  },
  "tags": [
    "rad_tag_01HGM5V65A5A5A5A5A5A5A5A5D"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Enter your API key in the format: Bearer

Body

application/json

username

string

required

The user's username. Must be unique within your workspace.

Example:

"[email protected]"

password

string

required

The user's password.

Example:

"S3cur3P@ssw0rd!"

status

enum<string>

default:active

required

The status of the user account.

Available options:

active,

disabled

groups

string[]

An array of group IDs to which this user should belong.

Example:

["rad_grp_01HGM5V65A5A5A5A5A5A5A5A5B"]

check_attributes

any

reply_attributes

any

metadata

any

Response

The user was created successfully.

Represents a RADIUS user account.

string

Unique identifier for the user.

Example:

"rad_usr_01HGM5V65A5A5A5A5A5A5A5A5A"

username

string

The username used for authentication.

Example:

"[email protected]"

status

enum<string>

The current status of the user account.

Available options:

active,

disabled

Example:

"active"

group_count

integer

The number of groups this user is a member of.

Example:

2

check_attributes

object[]

A list of RADIUS attributes used to check against the user's request during authorization.

Show child attributes

check_attributes.attribute

string

The name of the RADIUS attribute.

Example:

"Session-Timeout"

check_attributes.op

string

The operator to use for the attribute. := for assignment, == for checking.

Example:

":="

check_attributes.value

string

The value to assign or check for the attribute. The data type depends on the attribute.

Example:

"3600"

reply_attributes

object[]

A list of RADIUS attributes to be returned in the Access-Accept response.

Show child attributes

reply_attributes.attribute

string

The name of the RADIUS attribute.

Example:

"Session-Timeout"

reply_attributes.op

string

The operator to use for the attribute. := for assignment, == for checking.

Example:

":="

reply_attributes.value

string

The value to assign or check for the attribute. The data type depends on the attribute.

Example:

"3600"

metadata

object

A set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

Show child attributes

metadata.{key}

string

Example:

{ "employee_id": "E12345" }

Getting Started

Platform & Identity

Device Management & Orchestration

Automation & AI

Network Services & Connectivity

Security & Threat Management

Monitoring & Analytics

Core Services & Utilities

Authorizations

Body

Response