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 Groups API

Groups are named collections of email addresses; their members may be specified either by specific address, or by a wildcard including all addresses in an entire domain.

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

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

This API exposes 7 operations across 4 paths, and defines 4 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.

7 operations 4 paths 4 schemas 1 DELETE2 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 7

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

Groups 7

Groups are named collections of email addresses; their members may be specified either by specific address, or by a wildcard including all addresses in an entire domain.

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

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are GroupMetadata (4 properties), AddressMember (1 property), DomainMember (1 property). Each schema is shown below with its type and property counts.

DomainMember
object
1 property 1 required
GroupMembers
array
Input members data for adding/removing members from group, expects one of address or domain
GroupMetadata
object
Information about a group.
4 properties 1 required
AddressMember
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tessian-groups-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 Endpoints API
Tessian Events API
Tessian Monitoring API
Tessian Risk API
Tessian Triggers API