Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.1.0
info:
title: AppOmni Identity and Access API
description: 'Unified identities, AppOmni platform users, groups, roles and API authorization tokens.
Derived faithfully from the AppOmni public Postman collection published by AppOmni at https://api.appomni.com/
— every path, method, parameter, request body and example response below is taken verbatim from that
collection. No operation was invented.'
version: 1.0.0
contact:
name: AppOmni
url: https://appomni.com/support/
license:
name: Proprietary
url: https://appomni.com/terms-of-service/
x-generated-from: AppOmni public Postman collection (publishedId 2sBXc7Mjib, published 2026-02-04)
x-generated-source: https://api.appomni.com/api/collections/45135595/2sBXc7Mjib?segregateAuth=true&versionTag=latest
x-generated-method: derived
x-generated-date: '2026-09-04'
servers:
- url: https://{instance}.appomni.com
description: AppOmni tenant. Replace {instance} with your AppOmni subdomain — e.g. `acme` if you log
in at acme.appomni.com.
variables:
instance:
default: example
description: Your AppOmni tenant subdomain
security:
- bearerAuth: []
tags:
- name: Identity
description: "A Unified Identity represents a person and is composed of the different monitored service\
\ user accounts of that person, associated by email addresses.\n\n Monitored service users are users\
\ detected by scans of a specific monitored service."
- name: Users and Roles
- name: Authorization Tokens
paths:
/api/v1/core/unifiedidentity/annotated_list/:
get:
operationId: listUnifiedIdentities
summary: List unified identities
tags:
- Identity
description: "Returns a list of all unified identities.\n\n Response Fields\n\n Field \n Data Type\
\ \n Description \n Example \n\n id \n Integer \n Unique internal identifier for the unified identity\
\ \n 180452 \n\n created \n String (ISO 8601) \n Timestamp when the identity was created \n 2022-11-29T05:56:26.372253Z\
\ \n\n modified \n String (ISO 8601) \n Timestamp when the identity was last modified \n 2022-11-29T05:56:26.372264Z\
\ \n\n external_id \n String or null \n External identifier associated with the identity \n null\
\ \n\n identity_id \n UUID \n Unique identity ID for external reference \n 8590914a-a00a-4d0a-a9f4-626803eb9c1e\
\ \n\n identity_status \n String \n Status of the identity \n active \n\n identity_signature \n\
\ String \n Signature representing the identity, often an email \n user@example.com \n\n name\
\ \n String \n Display name of the identity \n John Doe \n\n name_akas \n Array[String] \n Alternative\
\ names or aliases \n [] \n\n email \n String \n Primary email address \n user@example.com \n\n\
\ primary_rbac_element_names \n Array[String] \n List of RBAC (role-based access control) roles\
\ \n [Member] \n\n user_controlled \n Boolean \n Whether the user directly controls the identity\
\ \n false \n\n idp_controlled \n Boolean \n Whether the identity is controlled by an Identity\
\ Provider \n false \n\n num_users_linked \n Integer \n Number of user accounts linked to this\
\ identity \n 4 \n\n num_users_active \n Integer \n Number of active users linked \n 1 \n\n num_users_highest_admin\
\ \n Integer \n Count of users with the highest level of admin access \n 0 \n\n num_users_highest_elevated\
\ \n Integer \n Count of users with elevated privileges \n 0 \n\n num_users_highest_standard \n\
\ Integer \n Count of users with standard access \n 4 \n\n num_users_inactive \n Integer \n Number\
\ of linked but inactive user accounts \n 0 \n\n num_users_disabled \n Integer \n Number of disabled\
\ user accounts \n 0 \n\n num_users_deprovisioned \n Integer \n Number of deprovisioned (removed)\
\ accounts \n 0 \n\n num_users_unknown \n Integer \n Number of users with unknown status \n 3\
\ \n\n any_elevated \n Boolean \n Indicates if any linked users have elevated permissions \n false\
\ \n\n any_admin \n Boolean \n Indicates if any linked users have admin access \n false \n\n user_label\
\ \n String or null \n Optional label associated with the user \n null \n\n notes \n String or\
\ null \n Optional notes related to the identity \n null \n\n tags \n Array[String] \n User-defined\
\ tags \n [] \n\n last_login \n String (ISO 8601) \n Last recorded login timestamp \n 2025-03-12T16:00:47Z\
\ \n\n last_login_msu_id \n String \n Composite ID for the last login (service type, ID, user\
\ ID) \n zoom:10861:abc123def456 \n\n services_linked \n Array[Integer] \n IDs of the services\
\ linked to this identity \n [10861, 25811, 59855, 59856] \n\n service_types \n Array[String]\
\ \n Types of services linked \n [lucid, zoom] \n\n service_names \n Array[String] \n Names of\
\ linked services \n [Service A, Service B, Service C, Service D] \n\n permission_level \n String\
\ \n Highest permission level among linked users \n standard \n\n last_login_ms_type \n String\
\ \n Service type of the most recent login \n zoom \n\n last_login_ms_id \n Integer \n Service\
\ ID of the most recent login \n 10861 \n\n last_login_user_id \n String \n User ID used during\
\ the last login \n abc123def456 \n\n tags \n Array[Integer] \n IDs of the tags associated to\
\ this identity \n [123, 456]"
responses:
'200':
description: List Unified Identities
content:
text/plain:
schema:
type: string
example: "{\n \"count\": -1,\n \"next\": \"https://coretest.int.appomni.com/api/v1/core/unifiedidentity/?limit=100&offset=100\"\
,\n \"previous\": null,\n \"results\": [\n {\n \"id\": 143568,\
\ // This is the internal ID of the unified identities, it can be used in the details\
\ endpoint \n \"identity_id\": \"8590914a-a00a-4d0a-a9f4-626803eb9c1e\", //\
\ This is an external reference ID for the identity\n \"services_linked\":\
\ [ // These are IDs of monitored services that has a linked MSU\n 10861,\n\
\ 25811,\n 59855,\n 59856\n ],\n\
\ \"service_types\": [ // These are unique names of monitored service types\
\ that have a linked MSU\n \"lucid\",\n \"zoom\"\n \
\ ],\n \"service_names\": [ // These are names of monitored services\
\ that have a linked MSU\n \"Lucid - 098453\",\n \"lucid-vj\"\
,\n \"lucid-vj-2\",\n \"Zoom Monitored Service 1\"\n \
\ ]\n // ... other fields omitted\n }\n ]\n}"
'401':
description: Unauthorized — missing or invalid AppOmni API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the token lacks permission for this resource
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/core/unifiedidentity/{identity_id}/:
get:
operationId: unifiedIdentityDetails
summary: Unified identity details
tags:
- Identity
description: "Returns details for a specific unified identity. Use the id from the List Unified\
\ Identities endpoint response above.\n\n Response Fields\n\n Field \n Data Type \n Description\
\ \n Example \n\n id \n Integer \n Unique internal identifier for the unified identity \n 180452\
\ \n\n created \n String (ISO 8601) \n Timestamp when the identity was created \n 2022-11-29T05:56:26.372253Z\
\ \n\n modified \n String (ISO 8601) \n Timestamp when the identity was last modified \n 2022-11-29T05:56:26.372264Z\
\ \n\n external_id \n String or null \n External identifier associated with the identity \n null\
\ \n\n identity_id \n UUID \n Unique identity ID for external reference \n 8590914a-a00a-4d0a-a9f4-626803eb9c1e\
\ \n\n identity_status \n String \n Status of the identity \n active \n\n identity_signature \n\
\ String \n Signature representing the identity, often an email \n user@example.com \n\n name\
\ \n String \n Display name of the identity \n John Doe \n\n name_akas \n Array[String] \n Alternative\
\ names or aliases \n [] \n\n email \n String \n Primary email address \n user@example.com \n\n\
\ primary_rbac_element_names \n Array[String] \n List of RBAC (role-based access control) roles\
\ \n [Member] \n\n user_controlled \n Boolean \n Whether the user directly controls the identity\
\ \n false \n\n idp_controlled \n Boolean \n Whether the identity is controlled by an Identity\
\ Provider \n false \n\n num_users_linked \n Integer \n Number of user accounts linked to this\
\ identity \n 4 \n\n num_users_active \n Integer \n Number of active users linked \n 1 \n\n num_users_highest_admin\
\ \n Integer \n Count of users with the highest level of admin access \n 0 \n\n num_users_highest_elevated\
\ \n Integer \n Count of users with elevated privileges \n 0 \n\n num_users_highest_standard \n\
\ Integer \n Count of users with standard access \n 4 \n\n num_users_inactive \n Integer \n Number\
\ of linked but inactive user accounts \n 0 \n\n num_users_disabled \n Integer \n Number of disabled\
\ user accounts \n 0 \n\n num_users_deprovisioned \n Integer \n Number of deprovisioned (removed)\
\ accounts \n 0 \n\n num_users_unknown \n Integer \n Number of users with unknown status \n 3\
\ \n\n any_elevated \n Boolean \n Indicates if any linked users have elevated permissions \n false\
\ \n\n any_admin \n Boolean \n Indicates if any linked users have admin access \n false \n\n user_label\
\ \n String or null \n Optional label associated with the user \n null \n\n notes \n String or\
\ null \n Optional notes related to the identity \n null \n\n tags \n Array[String] \n User-defined\
\ tags \n [] \n\n last_login \n String (ISO 8601) \n Last recorded login timestamp \n 2025-03-12T16:00:47Z\
\ \n\n last_login_msu_id \n String \n Composite ID for the last login (service type, ID, user\
\ ID) \n zoom:10861:abc123def456 \n\n services_linked \n Array[Integer] \n IDs of the services\
\ linked to this identity \n [10861, 25811, 59855, 59856] \n\n service_types \n Array[String]\
\ \n Types of services linked \n [lucid, zoom] \n\n service_names \n Array[String] \n Names of\
\ linked services \n [Service A, Service B, Service C, Service D] \n\n permission_level \n String\
\ \n Highest permission level among linked users \n standard \n\n last_login_ms_type \n String\
\ \n Service type of the most recent login \n zoom \n\n last_login_ms_id \n Integer \n Service\
\ ID of the most recent login \n 10861 \n\n last_login_user_id \n String \n User ID used during\
\ the last login \n abc123def456"
parameters:
- name: identity_id
in: path
required: true
description: Path parameter identity_id
schema:
type: string
responses:
'200':
description: Get Identity Details by UUID
content:
application/json:
schema:
type: object
examples:
GetIdentityDetailsbyUUID:
summary: Get Identity Details by UUID
value:
id: 13211
created: '2021-10-22T01:34:03.069775Z'
modified: '2021-10-22T01:34:03.069782Z'
external_id: null
identity_id: f9eaf6ad-bf00-446f-a370-ad3515e20aae
identity_status: active
identity_signature: se@appomni.com
name: Sales One Prod Authenticated
name_akas:
- Sales One Dev Authenticated
- AppOmni SE's
- Platform 1
- se+it
- Rogue 2
- SE UAT
- SE Demo
- Solutions Engineering
- se+unsanctioneduser
- se+malicioususer
- se+leadership
- Rogue One
- Demo Prod
- Jasper Chik
- Core 1
- Demo Dev
- Sales One
- Rogue1
- se+support
- John Smith
- Sales one
- se+PMM
- Core2
email: se+prod-sales1-unauthenticated@appomni.com
primary_rbac_element_names:
- Member
- System Administrator
- 'Custom: Sales Profile'
- Super Administrator
user_controlled: false
idp_controlled: false
num_users_linked: 25
num_users_active: 25
num_users_inactive: 0
any_elevated: true
any_admin: true
services_linked:
- 7543
- 7717
- 7720
- 11169
- 11264
- 12515
user_label: null
notes: null
tags: []
service_types:
- jira
- okta
- sfdc
- zoom
service_names:
- Zoom - Prod
- SFDC - Prod
- SFDC - Dev (staging)
- Okta - Prod
- SFDC - UAT
- Jira - Prod
'401':
description: Unauthorized — missing or invalid AppOmni API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the token lacks permission for this resource
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/core/unifiedidentity/{identity_id}/users:
get:
operationId: listMonitoredServiceUsersLinkedToAUnifiedIdentity
summary: List monitored service users linked to a unified identity
tags:
- Identity
description: "Returns a list of monitored service users linked to a specific unified identity.\n\
\n identity_id may be used instead of id in this endpoint.\n\n Response Fields\n\n Field \n Data\
\ Type \n Description \n Example \n\n count \n Integer \n Total number of user entries linked\
\ to the identity \n 4 \n\n next \n String or null \n URL to the next page of results (if paginated)\
\ \n null \n\n previous \n String or null \n URL to the previous page of results (if paginated)\
\ \n null \n\n results \n Array[Object] \n List of user entries associated with the identity \n\
\ [...] \n\n Linked Monitored Service User Schema\n\n Field \n Data Type \n Description \n Example\
\ \n\n id \n Integer \n Unique ID for the monitored service user identity mapping \n 442 \n\n\
\ identity_id \n UUID \n Unique ID for the monitored service user \n abc123def456 \n\n unified_identity_id\
\ \n Integer \n Associated unified identity ID \n 180452 \n\n service_org_id \n Integer \n Service\
\ organization ID this user belongs to \n 10861 \n\n service_type \n String \n Type of service\
\ (e.g., zoom, lucid) \n zoom \n\n service_type_slug \n String \n Slug version of the service\
\ type \n zoom \n\n service_org_name \n String \n Human-readable name of the service organization\
\ \n Service Name 1 \n\n user_id \n String \n Service-specific user ID \n abc123def456 \n\n active\
\ \n Boolean \n Whether the user account is marked as active \n true \n\n user_status \n String\
\ \n Status of the user \n active \n\n username \n String or null \n Optional username for the\
\ user \n user@example.com \n\n email \n String \n Email address of the user \n user@example.com\
\ \n\n name \n String \n Full name of the user \n John Doe \n\n is_internal_user \n Boolean \n\
\ Whether this user is an internal user \n true \n\n last_login \n String or null \n Last login\
\ time in ISO 8601 format, or null if never logged in \n 2025-03-12T16:00:47Z \n\n has_elevated_perms\
\ \n Boolean \n Whether the user has elevated permissions \n false \n\n has_admin_perms \n Boolean\
\ \n Whether the user has admin permissions \n false \n\n created_at_date \n String (ISO 8601)\
\ \n When the user identity record was created \n 2023-05-12T17:06:15Z \n\n user_type \n String\
\ or null \n Type of user (e.g., Basic, Licensed) or null \n Basic \n\n primary_rbac_element_id\
\ \n String or null \n ID of the primary RBAC element assigned \n 2 \n\n primary_rbac_element_name\
\ \n String or null \n Name of the primary RBAC element \n Member \n\n addl_primary_rbac_element_ids\
\ \n Array[String] \n Additional primary RBAC element IDs \n [] \n\n addl_primary_rbac_element_names\
\ \n Array[String] or null \n Additional primary RBAC element names \n [] \n\n permission_level\
\ \n String \n Effective permission level for this user \n standard"
parameters:
- name: identity_id
in: path
required: true
description: Path parameter identity_id
schema:
type: string
responses:
'200':
description: List Monitored Service Users Linked to a Unified Identity
content:
text/plain:
schema:
type: string
example: "{\n \"count\": 4,\n \"next\": null,\n \"previous\": null,\n \"results\"\
: [\n {\n \"id\": 2906, // the AppOmni identifier for this monitored\
\ service user\n \"unified_identity_id\": 180452, //the unified identity this\
\ MSU is linked to\n \"service_org_id\": 25811, // the ID of the monitored\
\ service this MSU is from\n \"service_type\": \"lucid\", // the service type\
\ of the monitored service, this can be `custom` for customer monitored services\n \
\ \"service_type_slug\": \"lucid\", // the unique slug of the monitored service\
\ this MSU is from used for lookup\n \"service_org_name\": \"Lucid - 098453\"\
, // name of the monitored service\n \"user_id\": \"lucid-177067822\", // id\
\ for the user within the monitored service itself\n },\n // ...other 3\
\ results omitted"
'401':
description: Unauthorized — missing or invalid AppOmni API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the token lacks permission for this resource
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/lucid/svcexp/{service_org_id}/user/{user_id}:
get:
operationId: getMonitoredServiceUserDetails
summary: Get monitored service user details
tags:
- Identity
description: "Returns the details of a specified monitored service user.\n\n Note : Monitored service\
\ users are users detected by scans of a specific monitored service. These users should not be\
\ confused with AppOmni users, which are users who can login to the AppOmni console.\n\n Response\
\ Fields\n\n Field \n Data Type \n Description \n Example \n\n id \n Integer \n Unique ID for\
\ the monitored service user identity mapping \n 442 \n\n identity_id \n UUID \n Unique ID for\
\ the monitored service user \n abc123def456 \n\n unified_identity_id \n Integer \n Associated\
\ unified identity ID \n 180452 \n\n service_org_id \n Integer \n Service organization ID this\
\ user belongs to \n 10861 \n\n service_type \n String \n Type of service (e.g., zoom, lucid)\
\ \n zoom \n\n service_type_slug \n String \n Slug version of the service type \n zoom \n\n service_org_name\
\ \n String \n Human-readable name of the service organization \n Service Name 1 \n\n user_id\
\ \n String \n Service-specific user ID \n abc123def456 \n\n active \n Boolean \n Whether the\
\ user account is marked as active \n true \n\n user_status \n String \n Status of the user \n\
\ active \n\n username \n String or null \n Optional username for the user \n user@example.com\
\ \n\n email \n String \n Email address of the user \n user@example.com \n\n name \n String \n\
\ Full name of the user \n John Doe \n\n is_internal_user \n Boolean \n Whether this user is an\
\ internal user \n true \n\n last_login \n String or null \n Last login time in ISO 8601 format,\
\ or null if never logged in \n 2025-03-12T16:00:47Z \n\n has_elevated_perms \n Boolean \n Whether\
\ the user has elevated permissions \n false \n\n has_admin_perms \n Boolean \n Whether the user\
\ has admin permissions \n false \n\n created_at_date \n String (ISO 8601) \n When the user identity\
\ record was created \n 2023-05-12T17:06:15Z \n\n user_type \n String or null \n Type of user\
\ (e.g., Basic, Licensed) or null \n Basic \n\n primary_rbac_element_id \n String or null \n ID\
\ of the primary RBAC element assigned \n 2 \n\n primary_rbac_element_name \n String or null \n\
\ Name of the primary RBAC element \n Member \n\n addl_primary_rbac_element_ids \n Array[String]\
\ \n Additional primary RBAC element IDs \n [] \n\n addl_primary_rbac_element_names \n Array[String]\
\ or null \n Additional primary RBAC element names \n [] \n\n permission_level \n String \n Effective\
\ permission level for this user \n standard"
parameters:
- name: service_org_id
in: path
required: true
description: Path parameter service_org_id
schema:
type: string
- name: user_id
in: path
required: true
description: Path parameter user_id
schema:
type: string
responses:
'200':
description: Get Monitored Service User Details
content:
text/plain:
schema:
type: string
example: "{\n \"id\": 2906, // id of the monitored service user\n \"user_id\": \"\
lucid-177067822\", //id for user within the monitored service\n \"unified_identity\"\
: 180452, // Unified identity this monitored service user is linked to\n\n // ....\
\ \n}"
'401':
description: Unauthorized — missing or invalid AppOmni API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the token lacks permission for this resource
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/identity/unifiedidentity/:
get:
operationId: listUnifiedIdentities2
summary: List Unified Identities
tags:
- Identity
description: "Returns a paginated list of unified identities.\n\n Filter Parameters\n\n Specified\
\ as query string parameters:\n\n Parameter \n Type \n Description \n Example \n\n any_admin \n\
\ Boolean \n Filter identities that have at least one linked admin user. \n true \n\n any_elevated\
\ \n Boolean \n Filter identities that have at least one linked elevated user. \n true \n\n created__gte\
\ \n String (ISO 8601) \n Filter identities created on or after the supplied timestamp. \n 2024-01-01T00:00:00Z\
\ \n\n created__lte \n String (ISO 8601) \n Filter identities created on or before the supplied\
\ timestamp. \n 2024-12-31T23:59:59Z \n\n email \n String \n Filter by primary email address.\
\ \n jane@example.com \n\n id \n String \n Filter by unified identity ID. \n 4e5ab37b-7d39-4fa8-9f14-6f2e74d9cd1f\
\ \n\n last_login__gte \n String (ISO 8601) \n Filter identities whose last login is on or after\
\ the supplied timestamp. \n 2024-09-01T00:00:00Z \n\n last_login__lte \n String (ISO 8601) \n\
\ Filter identities whose last login is on or before the supplied timestamp. \n 2024-09-30T23:59:59Z\
\ \n\n limit \n Integer \n Maximum number of records to return per page. \n 25 \n\n modified__gte\
\ \n String (ISO 8601) \n Filter identities modified on or after the supplied timestamp. \n 2024-07-01T00:00:00Z\
\ \n\n modified__lte \n String (ISO 8601) \n Filter identities modified on or before the supplied\
\ timestamp. \n 2024-07-31T23:59:59Z \n\n name \n String \n Filter by display name. \n Jane Doe\
\ \n\n offset \n Integer \n Number of records to skip before returning results. \n 0 \n\n ordering\
\ \n String \n Sort field list. Prefix a field with - for descending order. \n -last_login,name\
\ \n\n permission_level__in \n Array[String] \n Filter by one or more permission levels. Supported\
\ values: admin , elevated , standard , not_applicable . \n [\"admin\",\"elevated\"] \n\n search\
\ \n String \n Free-text search across indexed identity fields. Must be 3 to 256 characters. \n\
\ Jane \n\n services_linked__in \n Array[Integer] \n Filter by one or more linked monitored service\
\ IDs. \n [101,202,303] \n\n service_types__in \n Array[String] \n Filter by one or more linked\
\ monitored service type slugs. \n [\"github\",\"sfdc\"] \n\n status__in \n Array[String] \n Filter\
\ by one or more identity statuses. Supported values: active , inactive , disabled , deprovisioned\
\ , unknown . \n [\"active\",\"inactive\"] \n\n Sort Fields\n\n Use these public field names in\
\ ordering :\n\n Field \n Notes \n\n any_admin \n Boolean sort. \n\n any_elevated \n Boolean sort.\
\ \n\n created \n Creation timestamp. \n\n email \n Primary email. \n\n last_login \n Most recent\
\ linked login. \n\n modified \n Last modified timestamp. \n\n name \n Promoted display name.\
\ \n\n num_users_linked \n Count of linked monitored service users. \n\n permission_level \n Highest\
\ permission level observed. \n\n status \n Unified identity status. \n\n Examples:\n\n- ordering=name\
\ \n\n- ordering=-last_login \n\n- ordering=permission_level,-name \n\n Response Fields\n\n Paged\
\ response wrapper:\n\n Field \n Type \n Description \n Example \n\n count \n Integer \n Total\
\ number of matching records. \n 1 \n\n results \n Array[Object] \n List of unified identities\
\ for the current page. \n [...] \n\n Unified identity schema:\n\n Field \n Type \n Description\
\ \n Example \n\n id \n String \n Unique unified identity ID. \n 4e5ab37b-7d39-4fa8-9f14-6f2e74d9cd1f\
\ \n\n created \n String (ISO 8601) \n Timestamp when the identity was created. \n 2024-01-15T12:00:00Z\
\ \n\n modified \n String (ISO 8601) \n Timestamp when the identity was last modified. \n 2024-07-08T10:35:00Z\
\ \n\n email \n String \n Primary email address for the identity. \n jane@example.com \n\n identity_signature\
\ \n String \n Signature used to associate the identity, often an email-derived value. \n jane@example.com\
\ \n\n status \n String or null \n Current identity status. \n active \n\n last_login \n String\
\ (ISO 8601) or null \n Most recent login across linked users. \n 2024-07-08T10:30:00Z \n\n name\
\ \n String \n Current promoted display name. \n Jane Doe \n\n name_akas \n Array[String] or null\
\ \n Alternate names observed for the identity. \n [\"Jane Doe\",\"Jane Ann Doe\"] \n\n num_users_linked\
\ \n Integer \n Number of linked users co"
responses:
'200':
description: List Unified Identities
content:
application/json:
schema:
type: object
examples:
ListUnifiedIdentities:
summary: List Unified Identities
value:
count: 1
results:
- any_admin: true
any_elevated: true
created: '2024-01-15T12:00:00Z'
email: jane@example.com
id: 4e5ab37b-7d39-4fa8-9f14-6f2e74d9cd1f
identity_signature: jane@example.com
status: active
last_login: '2024-07-08T10:30:00Z'
modified: '2024-07-08T10:35:00Z'
name: Jane Doe
name_akas:
- Jane Doe
- Jane Ann Doe
num_users_active: 2
num_users_deprovisioned: 0
num_users_disabled: 0
num_users_highest_admin: 1
num_users_highest_elevated: 0
num_users_highest_standard: 1
num_users_inactive: 0
num_users_linked: 2
num_users_unknown_activity: 0
permission_level: admin
primary_rbac_element_names:
- admins
service_types:
- github
- google_workspace
service_names:
- GitHub
- Google Workspace
services_linked:
- 101
- 202
'401':
description: Unauthorized — missing or invalid AppOmni API token
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the token lacks permission for this resource
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/identity/unifiedidentity/{identity_id}/:
get:
operationId: getUnifiedIdentity
summary: Get Unified Identity
tags:
- Identity
description: "Returns details for the requested unified identity.\n\n Path Variables\n\n Variable\
\ \n Type \n Description \n Example \n\n uuid \n String \n The unique ID for the unified identity\
\ ID. \n 4e5ab37b-7d39-4fa8-9f14-6f2e74d9cd1f \n\n Response Fields\n\n Returns a unified identity:\n\
\n Field \n Type \n Description \n Example \n\n any_admin \n Boolean \n Whether any linked user\
\ has admin privileges. \n true \n\n any_elevated \n Boolean \n Whether any linked user has elevated\
\ privileges. \n true \n\n created \n String (ISO 8601) \n Timestamp when the identity was created.\
\ \n 2024-01-15T12:00:00Z \n\n email \n String \n Primary email address for the identity. \n jane@example.com\
\ \n\n id \n String \n Unique unified identity ID. \n 4e5ab37b-7d39-4fa8-9f14-6f2e74d9cd1f \n\n\
\ identity_signature \n String \n Signature used to associate the identity, often an email-derived\
\ value. \n jane@example.com \n\n last_login \n String (ISO 8601) or null \n Most recent login\
\ across linked users. \n 2024-07-08T10:30:00Z \n\n modi
# --- truncated at 32 KB (98 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/appomni/refs/heads/main/openapi/appomni-identity-api-openapi.yml