Search agentic identities | API Reference

POST

/v1/mgmt/agentic/identities/search

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

userId?string

clientId?string

resourceId?string

consentId?string

page?integer

Page number starting with 0 for the first page

Formatint32

limit?integer

Formatint32

List agentic identities — authorization records that bind an OAuth client to a user, tenant, or autonomous client. Filter by clientId, resourceId, userId, or consentId. Returns consent details, agent name, resource ID, and client ID for each identity.

Use page (zero-based) and limit for pagination.

curl -X POST "https://api.descope.com/v1/mgmt/agentic/identities/search" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/agentic/identities/search" \  -H "Content-Type: application/json" \  -d '{}'

ResponseOK

{
  "identities": [
    {
      "consent": {
        "id": "string",
        "appId": "string",
        "userId": "string",
        "scopes": [
          "string"
        ],
        "grantedBy": "string",
        "createdTime": 0,
        "tenantId": "string",
        "ExpireTime": 0,
        "modifiedTime": 0
      },
      "agentName": "string",
      "resourceId": "string",
      "clientId": "string",
      "createdBy": "string"
    }
  ],
  "total": 0
}

{  "identities": [    {      "consent": {        "id": "string",        "appId": "string",        "userId": "string",        "scopes": [          "string"        ],        "grantedBy": "string",        "createdTime": 0,        "tenantId": "string",        "ExpireTime": 0,        "modifiedTime": 0      },      "agentName": "string",      "resourceId": "string",      "clientId": "string",      "createdBy": "string"    }  ],  "total": 0}

TypeScript

export interface Response {
identities?: AgenticIdentity[]
total?: number
}
export interface AgenticIdentity {
consent?: ThirdPartyApplicationConsent
agentName?: string
resourceId?: string
clientId?: string
createdBy?: string
}
export interface ThirdPartyApplicationConsent {
id?: string
appId?: string
userId?: string
scopes?: string[]
grantedBy?: string
createdTime?: number
tenantId?: string
ExpireTime?: number
modifiedTime?: number
}

export interface Response {identities?: AgenticIdentity[]total?: number}export interface AgenticIdentity {consent?: ThirdPartyApplicationConsentagentName?: stringresourceId?: stringclientId?: stringcreatedBy?: string}export interface ThirdPartyApplicationConsent {id?: stringappId?: stringuserId?: stringscopes?: string[]grantedBy?: stringcreatedTime?: numbertenantId?: stringExpireTime?: numbermodifiedTime?: number}

Was this helpful?