Skip to main content
GET
/
api
/
v2
/
workspaces
/
{workspaceId}
/
agent
/
tools
/
users
/
{userId}
Agent tool get user details
curl --request GET \
  --url https://api.example.com/api/v2/workspaces/{workspaceId}/agent/tools/users/{userId}
{
  "data": {
    "success": true,
    "summary": "<string>",
    "user_id": "<string>",
    "display_name": "<string>",
    "user_principal_name": "<string>",
    "mail": "<string>",
    "job_title": "<string>",
    "department": "<string>",
    "office_location": "<string>",
    "mobile_phone": "<string>"
  },
  "meta": {
    "requestId": "<string>",
    "timestamp": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.contraforce.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
workspaceId
string<uuid>
required
​
userId
string
required

Response

OK

Standard v2 API response envelope for single-item responses.

​
data
object

Result of an agent user-lookup tool call. Returns a token-efficient view of a Microsoft Graph user with only the fields that have proven useful in incident analysis — full Graph payloads include large arrays of identities, business phones, and password change metadata that bloat LLM context without changing decisions.

​
meta
object