get_person

When to use

Use it once you have a person's reference. It makes up to three API calls and combines them, so one tool call answers who someone is, where they've worked and what's been said about them.

Call search_people first to get the reference this tool needs.

Parameters

referenceuuid·bodyrequired

The person's reference UUID.

Example

Ask your assistant something like this, and it makes the call below. The result is shown as the JSON the tool returns, which reaches the assistant as a text content item.

What has been said about Elena Marchetti since she joined Halberd?

Example records are invented.

Errors

These come back as a tool result with isError: true, so the assistant can read the reason and try again.

• Not found.No person has that reference.
• ownerships_note: Ownerships unavailable (…)Your plan excludes ownership data. The rest of the profile still returns.

Built on

The tool calls these endpoints with your own token. Use the API directly to get the same data into your own systems.

• GET/v1/profiles/{profileReference}
• GET/v1/profiles/{profileReference}/ownership
• GET/v1/profiles/{profileReference}/articles