Search third party application consents | API Reference

POST

/v1/mgmt/thirdparty/consents/search

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

appId?string

userId?string

consentId?string

page?integer

Page number starting with 0 for the first page

Formatint32

tenantId?string

limit?integer

Formatint32

Search OAuth user consents for Inbound Apps. Filter by appId, userId, consentId, or tenantId.

For agentic identities (MCP server authorizations), use Search agentic identities instead — it returns agent name, resource ID, and client ID alongside each consent.

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

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

ResponseOK

{
  "consents": [
    {
      "id": "string",
      "appId": "string",
      "userId": "string",
      "scopes": [
        "string"
      ],
      "grantedBy": "string",
      "createdTime": 0,
      "tenantId": "string",
      "ExpireTime": 0,
      "modifiedTime": 0
    }
  ],
  "total": 0
}

{  "consents": [    {      "id": "string",      "appId": "string",      "userId": "string",      "scopes": [        "string"      ],      "grantedBy": "string",      "createdTime": 0,      "tenantId": "string",      "ExpireTime": 0,      "modifiedTime": 0    }  ],  "total": 0}

TypeScript

export interface Response {
consents?: {
id?: string
appId?: string
userId?: string
scopes?: string[]
grantedBy?: string
createdTime?: number
tenantId?: string
ExpireTime?: number
modifiedTime?: number
}[]
total?: number
}

export interface Response {consents?: {id?: stringappId?: stringuserId?: stringscopes?: string[]grantedBy?: stringcreatedTime?: numbertenantId?: stringExpireTime?: numbermodifiedTime?: number}[]total?: number}

Was this helpful?