Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tessian Endpoints API

The Endpoints API from Tessian — 9 operation(s) for endpoints.

Tessian Endpoints API is one of 10 APIs that Tessian publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Endpoints. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 9 paths, and defines 25 schemas. It is described by OpenAPI 3.0.0, at version 1.0.1.

Requests are made against 2 base URLs: https://your-domain.tessian-platform.com, https://your-domain.tessian-app.com.

12 operations 9 paths 25 schemas 1 DELETE7 GET3 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.1
Base URL
https://your-domain.tessian-platform.com
Resource Areas
1

Paths & Operations 12

Across 9 paths, the API surfaces 12 operations — 1 DELETE, 7 GET, 3 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Endpoints 12
GET
/api/v1/events
Security Events
insights.external_api.main.get_events 3 params → 200400401403429500503504
GET
/reporting/anomalies/v1
Anomalies
insights.external_api.main.get_anomalies 2 params → 200400401403429500503504
GET
/api/v1/monitoring/users
Users
insights.external_api.main.get_users 2 params → 200400401403429500503504
GET
/api/v1/risk/company
Company Risks
insights.external_api.main.get_company_risk 2 params → 200400401403429500503504
GET
/api/v1/groups
Get Groups
insights.external_api.main.endpoint_groups_read 2 params → 200400401403429500503504
POST
/api/v1/groups
Create Group
insights.external_api.main.endpoint_group_create body → 200400401403429500503504
GET
/api/v1/groups/{id}
Read Group
insights.external_api.main.endpoint_group_read 3 params → 200400401403429500503504
PUT
/api/v1/groups/{id}
Update a group.
insights.external_api.main.endpoint_group_update 1 param body → 200400401403429500503504
DELETE
/api/v1/groups/{id}
Delete a group.
insights.external_api.main.endpoint_group_delete 1 param → 200400401403429500503504
POST
/api/v1/groups/{id}/add_members
Add group members
insights.external_api.main.endpoint_group_update_add 1 param body → 200400401403429500503504
POST
/api/v1/groups/{id}/remove_members
Remove group members
insights.external_api.main.endpoint_group_update_remove 1 param body → 200400401403429500503504
GET
/reporting/triggers/v1deprecated
Triggers
insights.external_api.main.get_triggers 3 params → 200400401403429500503504

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are Trigger (18 properties), Anomaly (9 properties), BaseEmailDetails (8 properties), ScoresDatapoint (7 properties). Each schema is shown below with its type and property counts.

ScoresDatapoint
object
risk drivers
7 properties 7 required
DefenderEvent
BaseEmailDetails
object
Details about an email.
8 properties 8 required
GroupMembers
array
Input members data for adding/removing members from group, expects one of address or domain
ArchitectEvent
Anomaly
object
9 properties
Event
BaseEvent
object
Properties that all events have.
5 properties 5 required
Attachment
object
Details about an attachment
2 properties
EnforcerTrigger
Represents a trigger by the Enforcer module
ConstructorTrigger
Represents a trigger by the Constructor module (legacy)
Links
object
Contains URLs that are associated with this event.
1 property
SyncState
string
How far along in the onboarding process the user is
GroupMetadata
object
Information about a group.
4 properties 1 required
OutboundEmailDetails
object
1 property 1 required
DomainMember
object
1 property 1 required
DefenderTrigger
Represents a trigger by the Defender module
ArchitectTrigger
Represents a trigger by the Architect module
InboundEmailDetails
object
1 property 1 required
AddressMember
object
1 property 1 required
Trigger
object
18 properties
GuardianEvent
OutboundTrigger
Represents a trigger for one of the outbound modules
GuardianTrigger
Represents a trigger for the Guardian module
UserMonitoringStatus
string
How well we have been connecting with the user

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tessian-endpoints-api-openapi.yml Raw ↑

Other APIs Tessian publishes across the network.

Tessian Anomalies API
Tessian Audits API
Tessian Beta Endpoints API
Tessian Deprecated API
Tessian Events API
Tessian Groups API
Tessian Monitoring API
Tessian Risk API
Tessian Triggers API