View as Markdown
Drata icon

Drata ACTION

Find Personnel

Find Personnel. See the documentation.
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Drata account once, then configure and run Find Personnel from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "drata-find-personnel",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    drata: { authProvisionId: "apn_xxxxxxx" },
    q: "Query",
    employmentStatuses: ["Employment Statuses"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Find Personnel inputs
Property Type Description
q Query string
Query to search for
Optional
employmentStatuses Employment Statuses string[]
Employment statuses to filter by
Optional
complianceTypes Compliance Types string[]
Compliance types to filter by
Optional
groupIds Group IDs integer[]
List of groups to find personnel by
Optional
useExclusions Use Exclusions boolean
Use exclusions on list personnel
Optional
mdmSourceType MDM Source Type string
MDM Source Type to filter by
Optional
inverseMdmSourceTypes Inverse MDM Source Types string[]
Inverse MDM Source Types to filter by
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
drata-find-personnel
Version
0.0.4
App
Drata
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes