AppSecEngineer Enterprise API (1.0.0)

Download OpenAPI specification:Download

E-mail: [email protected] License: Apache 2.0 Terms of Service

This is AppsecEngineer Enterprise API server console.

Find out more about AppSecEngineer

Generating API Token and Customer ID

As an admin, follow these steps to generate an API token and retrieve your customer ID:

Navigate to "My Profile" in the "My Account" section of the app
Look for the API token generation option in your profile
Generate a new token or copy your existing token and customer ID

Get completed courses and assignments by user ID

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

email of the user for which completed courses should be listed

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"error": true,
"data": [{"event_name": "string",
"id": "string",
"vid_duration": 0.1,
"lab_duration": 0.1
}
],
"assignments": [{"id": "string",
"end_date": "2019-08-24",
"name": "string",
"start_date": "2019-08-24"
}
]
}

Get active courses and assignments by user ID

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

email of the user for which completed courses should be listed

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"error": true,
"data": [{"event_name": "string",
"id": "string",
"vid_duration": 0.1,
"lab_duration": 0.1
}
],
"assignments": [{"id": "string",
"end_date": "2019-08-24",
"name": "string",
"start_date": "2019-08-24"
}
]
}

Get company user statistics by user ID

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

Company stats request body

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"data": [{"first_name": "string",
"last_name": "string",
"video_count": 0,
"lab_count": 0,
"media_count": 0,
"quiz_count": 0,
"email": "string"
}
]
}

Get team statistics

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

Team stats request body

team_id	string
select	string Enum: "overall" "monthly"

Responses

Request samples

Payload

Content type

application/json

{"team_id": "team_062c0918-e7eb-40e0-af3b-ecdca8b91f9f",
"select": "overall"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"data": {"activity": [{"activity": 0,
"date": "2019-08-24"
}
],
"progress": [{"course": "string",
"averageProgress": 0.1,
"duration": 0.1
}
],
"assignments": [{ }
],
"assign_completed": [{"assign": {"id": "string",
"end_date": "2019-08-24",
"name": "string",
"start_date": "2019-08-24"
},
"users": ["string"
]
}
],
"stat": {"assignments_completed": 0.1,
"badges": 0,
"challenges_completed": 0.1,
"doc_type": "string",
"enrolled": 0.1,
"lab_minutes": 0.1,
"labs_completed": 0.1,
"video_minutes": 0.1,
"videos_completed": 0.1
},
"recent": [{"activity": "string",
"item": "string",
"date": "string"
}
],
"items": [{"first_name": "string",
"last_name": "string",
"lab_minutes": 0.1,
"course_minutes": 0.1,
"email": "string"
}
]
}
}

Get proficiency report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Responses

Response samples

200
400
500

Content type

application/json

{"message": "string",
"success": true,
"data": [{"type": "string",
"total_enroll_count": 0,
"courses": [{"event_name": "string",
"enroll_count": 0
}
]
}
]
}

Get learning path report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Responses

Response samples

200
400
500

Content type

application/json

{"message": "string",
"success": true,
"error": true,
"data": {"lab_duration": [{"lpId": "string",
"learning_path_name": "string",
"lab_duration": 0.1
}
],
"vid_duration": [{"lpId": "string",
"learning_path_name": "string",
"vid_duration": 0.1
}
]
}
}

Get learning path completed report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Responses

Response samples

200
400
500

Content type

application/json

{"message": "string",
"success": true,
"data": [{"completed_count": 0.1,
"lp": "string",
"learning_path_name": "string"
}
]
}

Get journey report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

Journey report request body

skip	integer Number of records to skip.
limit	integer Maximum number of records to return.

Responses

Request samples

Payload

Content type

application/json

{"skip": 0,
"limit": 0
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"data": [{"journey_id": "string",
"enroll_count": 0,
"journey": {"proficiency": "string",
"id": "string",
"description": "string",
"logo": "string",
"duration": 0,
"name": "string"
}
}
]
}

Get user activity

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

User activity request body

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"data": [{"activity": 0,
"date": "2019-08-24"
}
]
}

Get user report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

User report request body

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"error": true,
"data": {"challenges_completed": 0,
"labs_completed": 0,
"videos_completed": 0,
"badges": 0,
"total_enrolled": 0,
"dashboard": [{"activity": 0,
"date": "2019-08-24"
}
],
"total_course_minutes": 0,
"month_lab_minutes": 0,
"total_lab_minutes": 0
}
}

Get individual journey report

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

Individual journey report request body

id	string Journey ID
skip	integer Number of records to skip
limit	integer Maximum number of records to return

Responses

Request samples

Payload

Content type

application/json

{"id": "string",
"skip": 0,
"limit": 0
}

Response samples

200
400
500

Content type

application/json

{"data": {"ttl": 0,
"logo": "string",
"name": "string",
"active": true,
"roles": ["string"
],
"events": ["string"
],
"proficiency": "string",
"id": "string",
"description": "string",
"type": "string",
"duration": 0,
"created_on": "2019-08-24T14:15:22Z",
"report": {"avg_user_progress": [{"email": "[email protected]",
"avg_progress": 0.1,
"first_name": "string",
"last_name": "string"
}
],
"avg_progress": 0.1,
"avg_course_progress": {"property1": 0.1,
"property2": 0.1
},
"completed": [{"email": "[email protected]",
"completed_courses": 0,
"first_name": "string",
"last_name": "string"
}
]
},
"skills": [{"date": "2019-08-24",
"topTag": "string",
"count": 0
}
]
},
"success": true,
"error": true
}

Get top users (overall or monthly)

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json
required

Top users report request body

user_id

string

Responses

Request samples

Payload

Content type

application/json

{"user_id": "[email protected]"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"data": {"data": [{"first_name": "User1",
"last_name": "User1",
"lab_minutes": 100,
"assignments_completed": 5,
"course_minutes": 200,
"email": "[email protected]",
"challenge_completed": 2
},
{"first_name": "User2",
"last_name": "User2",
"lab_minutes": 150,
"assignments_completed": 10,
"course_minutes": 250,
"email": "[email protected]",
"challenge_completed": 7
}
],
"badges": 10,
"total": 100
}
}

List all teams for a customer

header Parameters

X-ASE-API-Token required	string <uuid>
X-ASE-Customer-ID required	string <uuid>

Request Body schema: application/json

Optional pagination model for listing teams

pagination

string

Responses

Request samples

Payload

Content type

application/json

{"pagination": "string"
}

Response samples

200
400
500

Content type

application/json

{"success": true,
"error": false,
"data": {"Items": [{"stat": [{"lp": "AWS Security",
"duration": 1106,
"percentage": 19.56
},
{"lp": "Application Security",
"duration": 1025,
"percentage": 18.13
},
{"lp": "Advanced Application Security",
"duration": 1054,
"percentage": 18.64
},
{"lp": "DevSecOps",
"duration": 989,
"percentage": 17.49
},
{"lp": "Azure Security",
"duration": 219,
"percentage": 3.87
},
{"lp": "Kubernetes Security",
"duration": 1196,
"percentage": 21.15
},
{"lp": "Threat Modeling",
"duration": 66,
"percentage": 1.17
}
],
"team_name": "team Alpha",
"id": "team_2dd61b4c-46f5-487e-8ba0-ff00f69fcb15",
"search_name": "team alpha",
"type": "team#company_4923834b-81d4-4b2a-830c-d5e4382d4e89",
"created_on": "2024-09-04T07:45:07.976470",
"lab_minutes": 1940,
"video_minutes": 3711
},
{"stat": [{"lp": "AWS Security",
"duration": 1237,
"percentage": 23.31
},
{"lp": "Application Security",
"duration": 678,
"percentage": 12.78
},
{"lp": "Advanced Application Security",
"duration": 1074,
"percentage": 20.24
},
{"lp": "DevSecOps",
"duration": 706,
"percentage": 13.31
},
{"lp": "Azure Security",
"duration": 271,
"percentage": 5.11
},
{"lp": "Kubernetes Security",
"duration": 1185,
"percentage": 22.33
},
{"lp": "Threat Modeling",
"duration": 155,
"percentage": 2.92
}
],
"team_name": "Team Appsec",
"id": "team_32176c13-3fad-4925-9680-b83d8af1b6f8",
"search_name": "team appsec",
"type": "team#company_4923834b-81d4-4b2a-830c-d5e4382d4e89",
"created_on": "2024-07-29T11:16:28.388513",
"lab_minutes": 2655,
"video_minutes": 2647
}
]
}
}

AppSecEngineer Enterprise API (1.0.0)

Generating API Token and Customer ID

Get completed courses and assignments by user ID

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get active courses and assignments by user ID

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get company user statistics by user ID

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get team statistics

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get proficiency report

header Parameters

Responses

Response samples

Get learning path report

header Parameters

Responses

Response samples

Get learning path completed report

header Parameters

Responses

Response samples

Get journey report

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get user activity

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get user report

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get individual journey report

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get top users (overall or monthly)

header Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

List all teams for a customer

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required