Overview
Policies
Webhooks
Policy Groups
HITL Approvals
Tasks
Push Notifications
User Subscriptions
Agents
Agent Subscriptions
Identity Providers
Groups
- GETList groups within a tenant
- GETGet group by ID
- GETList members of a group
- GETList all versions of a group (audit history)
- GETList groups a user belongs to
- POSTCreate a group
- POSTAdd users to a group
- PUTUpdate a group (creates new immutable version)
- DELArchive a group (soft delete)
- DELRemove a user from a group
Authentication
- GETDiscover login method for an email address
- GETGet current user's identity, groups, and effective permissions
- GETList all possible entity-permission combinations
- POSTAccept a user invite and set password
- POSTRequest a password reset email
- POSTLogin and obtain access token
- POSTRefresh access token
- POSTResend verification email
- POSTReset password using token
- POSTExchange SSO authorization code for tokens
- POSTVerify email address using token
Users
Audit Events
Audit Traces
Get an identity provider by ID
Copy
curl --request GET \
--url https://api.swarmd.ai/tenant-auth/v1/identity-providers/{identityProviderId} \
--header 'Authorization: Bearer <token>'Copy
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"providerType": "<string>",
"alias": "<string>",
"displayName": "<string>",
"enabled": true,
"config": {},
"groupMappings": {},
"emailDomains": [
"<string>"
],
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}Identity Providers
Get an identity provider by ID
Security Requirements
| Auth Types | Entities | Permissions | Required Roles |
|---|---|---|---|
| USER | IDENTITY_PROVIDERS | READ | IDENTITY_PROVIDERS:READ |
GET
/
tenant-auth
/
v1
/
identity-providers
/
{identityProviderId}
Get an identity provider by ID
Copy
curl --request GET \
--url https://api.swarmd.ai/tenant-auth/v1/identity-providers/{identityProviderId} \
--header 'Authorization: Bearer <token>'Copy
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"tenantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"providerType": "<string>",
"alias": "<string>",
"displayName": "<string>",
"enabled": true,
"config": {},
"groupMappings": {},
"emailDomains": [
"<string>"
],
"createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}Authorizations
JWT token (USER, AGENT, or SERVICE auth)
Path Parameters
⌘I