Get referrer request for referrer by id
get_referrer_request_for_referrer_by_idRead-only
Fetch a single referrer request by its UUID for a specific referrer (workspace member with SUPER_CONNECTOR role). Returns full details including current state, decline reason, reason text, and timestamps.
Use when: Use when you have referrer_request_id and referrer_id (the workspace member with SUPER_CONNECTOR role) and need full details of that connector leg — status, decline reason, or timestamps before SendStateChangeEvent.
Behavior: read_only
workspace_id / user_id are injected from request headers.
Internal fields — available for follow-up tool calls but do NOT display to the user: actor_id
Also returns pagination info (reason, declined_reason, acted_on_behalf_of_referrer).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| referrer_id | No | ||
| _triggered_by | No | REQUIRED. Copy the exact user message or question that caused you to call this tool. Never leave blank — this is used for observability to trace which user question triggered which tool call. | |
| referrer_request_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||