Group-Safe-TimePolicy Management

Endpoints in this section allow you to manage the time policy for accessing safes assigned to a group.


Data Structures

GroupSafeTimePolicyModel

Attribute

Type

Required

Description

id

string

Read-only. Unique identifier.

group_safe_id

string

Read-only; protected.

group_id

string

yes

Immutable. Requires rights on the group object: read for GET, modify for POST, PATCH, and DELETE.

safe_id

string

yes

Immutable. Requires read right on the safe object for all operations.

group_name

string

Read-only; expensive to use.

safe_name

string

Read-only; expensive to use.

day_of_week

number

yes

Value range from 1 to 7.

valid_from

datetime

yes

Daily access start time.

valid_to

datetime

yes

Daily access end time.

created_at

datetime

Read-only. Timestamp of creation.

modified_at

datetime

Read-only. Timestamp of modification.

removed

boolean

Read-only.

Retrieve Available Attributes of the GroupSafeTimePolicyModel

Request

Method

GET

Path

/api/v2/objspec/group_safe_time_policy

GET /api/v2/objspec/group_safe_time_policy

Example Request

curl -s -k -X GET \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  'https://10.31.135.179/api/v2/objspec/group_safe_time_policy'

Get Group-Safe-TimePolicy Assignment List

Request

Method

GET

Path

/api/v2/group/safe/time_policy

GET /api/v2/group/safe/time_policy

Example Request

curl -s -k -X GET \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  'https://10.0.214.98/api/v2/group/safe/time_policy'

Response

{
    "result": "success",
    "group_safe_time_policy": [
        {
            "id": "9115285645797883905",
            "group_id": "9115285645797883906",
            "safe_id": "9115285645797883907",
            "group_name": "QA_team",
            "safe_name": "SSH",
            "day_of_week": 1,
            "valid_from": "06:00:00",
            "valid_to": "08:00:00",
            "created_at": "2025-05-08 03:12:37.235474-07",
            "modified_at": "2025-05-08 03:12:37.235474-07"
        },
        {
            "id": "9115285645797883906",
            "group_id": "9115285645797883906",
            "safe_id": "9115285645797883907",
            "group_name": "QA_team",
            "safe_name": "SSH",
            "day_of_week": 1,
            "valid_from": "10:00:00",
            "valid_to": "12:00:00",
            "created_at": "2025-05-08 03:12:37.254555-07",
            "modified_at": "2025-05-08 03:12:37.254555-07"
        },
        {
            "id": "9115285645797883909",
            "group_id": "9115285645797883906",
            "safe_id": "9115285645797883907",
            "group_name": "QA_team",
            "safe_name": "SSH",
            "day_of_week": 2,
            "valid_from": "08:00:00",
            "valid_to": "10:00:00",
            "created_at": "2025-05-08 03:12:37.302277-07",
            "modified_at": "2025-05-08 03:12:37.302277-07"
        },
    ]
}

Get Group-Safe-TimePolicy Assignment by ID

Request

Method

GET

Path

/group/safe/time_policy/<id>

GET /api/v2/group/safe/time_policy/<id>

Example Request

curl -s -k -X GET \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  'https://10.0.214.98/api/v2/group/safe/time_policy/9115285645797883909'

Response

{
    "result": "success",
    "group_safe_time_policy": {
        "id": "9115285645797883909",
        "group_id": "9115285645797883906",
        "safe_id": "9115285645797883907",
        "group_name": "QA_team",
        "safe_name": "SSH",
        "day_of_week": 2,
        "valid_from": "08:00:00",
        "valid_to": "10:00:00",
        "created_at": "2025-05-08 03:12:37.302277-07",
        "modified_at": "2025-05-08 03:12:37.302277-07"
    }
}

Create Group-Safe-TimePolicy Assignment

Request

Method

POST

Path

/api/v2/group/safe/time_policy

Headers

Content-Type: Application/json

Body

GroupSafeTimePolicyModel

POST /api/v2/group/safe/time_policy

Example Request

curl -s -k -X POST \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  -H 'Content-Type: application/json' \
  'https://10.0.214.98/api/v2/group/safe/time_policy' \
  -d'{"group_id":"9115285645797883906","safe_id":"9115285645797883907","day_of_week":5,"valid_from":"06:00:00","valid_to":"12:00:00"}'

Response

{
    "result": "success",
    "group_safe_time_policy": {
        "id": "9115285645797883914"
    }
}

Modify Group-Safe-TimePolicy Assignment

Request

Method

PATCH

Path

/api/v2/group/safe/time_policy/<id>

Headers

Content-Type: Application/json

Body

GroupSafeTimePolicyModel

PATCH /api/v2/group/safe/time_policy/<id>

Example Request

curl -s -k -X PATCH \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  -H 'Content-Type: application/json' \
  'https://10.31.135.179/api/v2/group/safe/time_policy/9115285645797883915' \
  -d'{"day_of_week":3,"valid_from":"06:00:00","valid_to":"12:00:00"}'

Response

{
    "result": "success"
}

Delete Group-Safe-TimePolicy Assignment

Request

Method

DELETE

Path

/api/v2/group/safe/time_policy/<id>

DELETE /api/v2/group/safe/time_policy/<id>

Example Request

curl -s -k -X DELETE \
  -H 'Authorization: sgfeea6jsaz4mum9su8w6' \
  'https://10.31.135.179/api/v2/group/safe/time_policy/9115285645797883915'

Response

{
    "result": "success"
}