Drata

Drata Personnel API

Personnel are people who work for your organization. The [help docs](https://help.drata.com/en/collections/2653981) have more information.

GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /personnel List personnel records · List Personnel #
Ask an LLM
“Which employees on our personnel roster are out of compliance right now?”
“Can I page through the full personnel list filtered by employment status?”
Tell an agent
List all personnel records with employment status {employmentStatus}.
Page through the personnel roster where overall compliance status is {complianceStatus}.
GET /personnel-search Search personnel across all workspaces · Search Personnel across all workspaces #
Ask an LLM
“How do I find a person by name or email across every workspace I can access?”
“Which people in any workspace are missing MFA or security training?”
Tell an agent
Search every workspace for personnel matching {q}.
Find personnel in all workspaces whose disk encryption status is {diskEncryptionStatus}.
GET /workspaces/{workspaceId}/personnel-search Search personnel within one workspace · Search Personnel within a workspace #
Ask an LLM
“Can I search the people in a single workspace by first name prefix?”
“Which people in one specific workspace haven't completed HIPAA training?”
Tell an agent
Search workspace {workspaceId} for personnel matching {q}.
In workspace {workspaceId}, find people whose background check status is {bgCheckStatus}.
GET /personnel/{personnelId} Get one person's personnel record · Get Personnel #
Ask an LLM
“How do I pull up a single employee's personnel record using their email?”
“What does Drata hold on file for one specific person?”
Tell an agent
Get the personnel record for {personnelId}.
Show personnel {personnelId} with {expand} expanded.
PUT /personnel/{personnelId} Update a person's employment details · Update Personnel #
Ask an LLM
“How do I record the separation date for someone who left the company?”
“Will editing a person's start date by hand stop HRIS sync from overwriting it?”
Tell an agent
Set the separation date of personnel {personnelId} to {separatedAt}.
Change the employment status of {personnelId} to {employmentStatus}.
POST /personnel/actions Reset personnel IdP/HRIS sync · Reset Personnel Sync #
Ask an LLM
“How can I restore automatic identity provider updates after editing people manually?”
“Is it possible to reset HRIS sync for every person at once?”
Tell an agent
Run the {action} action on personnel {personnelIds}.
Reset IdP and HRIS sync for all personnel.
GET /workspaces/{workspaceId}/scoped-personnel-groups List groups in a workspace's personnel scope · List Workspace Scoped Personnel Groups 🧪 #
Ask an LLM
“Which personnel groups are currently in scope for a workspace?”
“What teams decide who counts as personnel in a given workspace?”
Tell an agent
List the personnel groups scoped to workspace {workspaceId}.
Show the scoped groups for workspace {workspaceId}, {size} per page.
POST /workspaces/{workspaceId}/scoped-personnel-groups Add a group to a workspace's personnel scope · Add Personnel Group To Workspace Scope 🧪 #
Ask an LLM
“How do I add one more team to a workspace's personnel scope?”
“What error comes back if the group I'm adding to the scope is already assigned?”
Tell an agent
Add group {groupId} to the personnel scope of workspace {workspaceId}.
Bring personnel group {groupId} into scope for workspace {workspaceId}.
PUT /workspaces/{workspaceId}/scoped-personnel-groups Replace a workspace's scoped personnel groups · Replace Workspace Scoped Personnel Groups 🧪 #
Ask an LLM
“Can I set the exact list of groups in a workspace's personnel scope in one call?”
“What happens to scoped groups I leave out when I overwrite the whole scope?”
Tell an agent
Replace the personnel scope of workspace {workspaceId} with groups {groupIds}.
Make {groupIds} the only groups in scope for workspace {workspaceId}.
DELETE /workspaces/{workspaceId}/scoped-personnel-groups/{groupId} Remove a group from a workspace's personnel scope · Remove Personnel Group From Workspace Scope 🧪 #
Ask an LLM
“Can I take a single department out of a workspace's scope without resending the full list?”
“Which call drops just one group from a workspace's personnel scope?”
Tell an agent destructive · confirm first
Remove group {groupId} from workspace {workspaceId}'s personnel scope.
Take personnel group {groupId} out of scope for workspace {workspaceId}.
GET /workspaces/{workspaceId}/scoped-personnel-counts Count personnel in a workspace's scope · Get Workspace Scoped Personnel Counts 🧪 #
Ask an LLM
“How many people are reachable through a workspace's scoped groups?”
“Can I compare a workspace's scoped headcount with the total IdP-connected personnel?”
Tell an agent
Count the scoped personnel for workspace {workspaceId}.
Get scoped versus IdP-connected personnel totals for workspace {workspaceId}.

Documentation

📖
Documentation
https://developers.drata.com/openapi/reference/v2/overview/
📖
APIReference
https://developers.drata.com/openapi/reference/v2/overview/
📖
GettingStarted
https://developers.drata.com/developer-portal/v2/recipes/create-an-api-key/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/drata/refs/heads/main/authentication/drata-authentication.yml
📖
Documentation
https://developers.drata.com/openapi/reference/v2/tag/Custom-Connections/
📖
GettingStarted
https://developers.drata.com/developer-portal/v2/recipes/custom-connections/
📖
Documentation
https://docs.safebase.io/reference/getaccounts
📖
APIReference
https://docs.safebase.io/reference/getaccounts

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/drata/refs/heads/main/openapi/drata-personnel-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/drata:drata-personnel-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

drata-personnel-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Drata Personnel API
  description: '### What''s New in V2

    - Support for Custom Fields

    - Get and acknowledge user''s assigned policies

    - Payloads are streamlined to include only the essential information.'
  version: V2
  contact: {}
servers:
- url: https://public-api.drata.com/public/v2
- url: https://public-api.eu.drata.com/public/v2
- url: https://public-api.apac.drata.com/public/v2
tags:


# --- truncated at 32 KB (94 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/drata/refs/heads/main/openapi/drata-personnel-api-openapi.yml