Governance
Get a human task
Get a human task. Requires a Personal key and permission approvals:read.
GET
/
api
/
v3
/
governance-human-tasks
/
{humanTaskId}
Get a human task
curl --request GET \
--url https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"humanTask": {
"humanTaskId": "<string>",
"humanTaskKind": "trust_fabric_hold",
"state": "created",
"prompt": {
"version": 2,
"title": "<string>",
"summary": "<string>",
"detail": "<string>",
"metadata": {
"decisionPacket": {
"schemaVersion": "v1",
"title": "<string>",
"question": "<string>",
"summary": "<string>",
"approveEffect": "<string>",
"rejectEffect": "<string>",
"recommendation": {
"decision": "approve",
"rationale": "<string>"
},
"impact": [
{
"label": "<string>",
"value": "<string>",
"tone": "neutral"
}
],
"exceptions": [
{
"key": "<string>",
"label": "<string>",
"severity": "info",
"summary": "<string>",
"evidence": [
{
"kind": "step_output",
"stepId": "<string>",
"field": "<string>",
"label": "<string>"
}
],
"amount": "<string>",
"affectedEntities": [
"<string>"
]
}
],
"primaryArtifactFileId": "<string>"
},
"agentRecommendation": {
"summary": "<string>",
"confidence": 123,
"recommendation": "<string>"
},
"impactPreview": {
"downstreamCount": 123,
"estCost": 123,
"estDurationSec": 123,
"riskFlags": [
"<string>"
]
},
"nodePosition": {
"index": 123,
"total": 123
},
"assigneeSlackUserId": "<string>",
"workflowName": "<string>",
"vendorName": "<string>",
"stepId": "<string>",
"nodeName": "<string>",
"runId": "<string>",
"nodeId": "<string>",
"runStartedAtMs": 123,
"runTotalCostUsd": 123,
"runTriggeredBySlackUserId": "<string>",
"runTriggeredByDisplay": "<string>",
"timeoutAtMs": 123,
"resolvedInputs": [
{
"key": "<string>",
"type": "<string>",
"display": "<string>",
"description": "<string>",
"value": "<unknown>",
"files": [
{
"fileId": "<string>",
"filename": "<string>",
"mimeType": "<string>",
"sizeBytes": 123
}
]
}
],
"agentSetup": {
"agentId": "<string>",
"agentName": "<string>",
"checkIds": [
"worker_seated"
],
"note": "<string>",
"requestedByPersonId": "<string>"
},
"argsPreview": {
"json": "<string>",
"truncated": true,
"redactedPaths": 123,
"egressHosts": [
"<string>"
]
},
"holdContext": {
"externalDelivery": true
},
"nodeContext": {
"decisionPacket": true
},
"requestedByApp": {
"via": "external_app",
"name": "<string>"
}
}
},
"form": {
"version": 2,
"schema": {
"type": "object",
"properties": {},
"required": [
"<string>"
],
"xForgeOrder": [
"<string>"
]
},
"actions": [
{
"id": "<string>",
"label": "<string>",
"doneLabel": "<string>",
"style": "primary",
"effect": "permit",
"requires": [
"<string>"
],
"assurance": "none"
}
]
},
"dueAt": 123,
"isCandidate": true,
"claimable": true,
"canTakeOver": true,
"reassignRef": {
"kind": "approval",
"id": "<string>"
},
"candidateCount": 123,
"consoleUrl": "<string>",
"actionTaken": "<string>",
"output": {},
"completionReason": "<string>",
"cancelReason": "due_date",
"assignee": "<string>"
}
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "resource_missing",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}The reference panel describes the current v3 operation. The notes below describe its v2 compatibility API. Follow the v3 request schema for current calls: v3 can move identifiers from the body or query into the URL. Keep the v2 method, path, and payload together when using the compatibility API.
v2 compatibility notes
Reads one human task as the Personal key’s owner sees it in the Forge Console: its prompt and v2 form with the actions that answer it, what was decided (actionTaken, output, completionReason)
or why it was canceled, and what the owner may do (claimable, canTakeOver).
Who sees a task
The owner sees a task that asks them (isCandidate), one they watch, or one they asked for. An owner
who holds approvals:approve at the task’s home also sees a hold or a workflow step they may take
over (canTakeOver, with its reassignRef) — but only through a key whose scopes reach
approvals:approve: a key carrying approvals:read alone never reports take-over. A review queue’s
group task asks everyone who holds the queue’s permission at the platform scope now, through the key’s
scopes; the owner may take over its claim when they also hold approvals:approve at the platform scope,
and its reassignRef is { "kind": "human_task", "id": <task id> }. A task the owner
may not see, a missing task and a malformed id all answer the same 404.
A platform key or an External App gets 403 with error.personRequired: true. See
Person-relative reads.
Parameters
| Parameter | Required | Meaning |
|---|---|---|
id | Yes | The human task id (humanTaskId on a My Work item). |
Example
curl "$FORGE_BASE/api/v2/governance/getHumanTask?id=hir_456" \
-H "Authorization: Bearer $FORGE_PERSONAL_KEY"
{ "data": { "humanTask": { … } }, "meta": { "requestId": "…" } }; humanTask
follows the HumanTaskView schema. The MCP tool forge_get_human_task returns the same data and
meta.Authorizations
A Personal key (fmcp_…), bound to the person who created it, or an interactive MCP sign-in that resolves to one. Pass as Authorization: Bearer <key>. It acts for that person, under their role grants narrowed by its scopes; an operation that acts for a person admits only this kind.
Path Parameters
⌘I
Get a human task
curl --request GET \
--url https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.forge.gloo.com/api/v3/governance-human-tasks/{humanTaskId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"humanTask": {
"humanTaskId": "<string>",
"humanTaskKind": "trust_fabric_hold",
"state": "created",
"prompt": {
"version": 2,
"title": "<string>",
"summary": "<string>",
"detail": "<string>",
"metadata": {
"decisionPacket": {
"schemaVersion": "v1",
"title": "<string>",
"question": "<string>",
"summary": "<string>",
"approveEffect": "<string>",
"rejectEffect": "<string>",
"recommendation": {
"decision": "approve",
"rationale": "<string>"
},
"impact": [
{
"label": "<string>",
"value": "<string>",
"tone": "neutral"
}
],
"exceptions": [
{
"key": "<string>",
"label": "<string>",
"severity": "info",
"summary": "<string>",
"evidence": [
{
"kind": "step_output",
"stepId": "<string>",
"field": "<string>",
"label": "<string>"
}
],
"amount": "<string>",
"affectedEntities": [
"<string>"
]
}
],
"primaryArtifactFileId": "<string>"
},
"agentRecommendation": {
"summary": "<string>",
"confidence": 123,
"recommendation": "<string>"
},
"impactPreview": {
"downstreamCount": 123,
"estCost": 123,
"estDurationSec": 123,
"riskFlags": [
"<string>"
]
},
"nodePosition": {
"index": 123,
"total": 123
},
"assigneeSlackUserId": "<string>",
"workflowName": "<string>",
"vendorName": "<string>",
"stepId": "<string>",
"nodeName": "<string>",
"runId": "<string>",
"nodeId": "<string>",
"runStartedAtMs": 123,
"runTotalCostUsd": 123,
"runTriggeredBySlackUserId": "<string>",
"runTriggeredByDisplay": "<string>",
"timeoutAtMs": 123,
"resolvedInputs": [
{
"key": "<string>",
"type": "<string>",
"display": "<string>",
"description": "<string>",
"value": "<unknown>",
"files": [
{
"fileId": "<string>",
"filename": "<string>",
"mimeType": "<string>",
"sizeBytes": 123
}
]
}
],
"agentSetup": {
"agentId": "<string>",
"agentName": "<string>",
"checkIds": [
"worker_seated"
],
"note": "<string>",
"requestedByPersonId": "<string>"
},
"argsPreview": {
"json": "<string>",
"truncated": true,
"redactedPaths": 123,
"egressHosts": [
"<string>"
]
},
"holdContext": {
"externalDelivery": true
},
"nodeContext": {
"decisionPacket": true
},
"requestedByApp": {
"via": "external_app",
"name": "<string>"
}
}
},
"form": {
"version": 2,
"schema": {
"type": "object",
"properties": {},
"required": [
"<string>"
],
"xForgeOrder": [
"<string>"
]
},
"actions": [
{
"id": "<string>",
"label": "<string>",
"doneLabel": "<string>",
"style": "primary",
"effect": "permit",
"requires": [
"<string>"
],
"assurance": "none"
}
]
},
"dueAt": 123,
"isCandidate": true,
"claimable": true,
"canTakeOver": true,
"reassignRef": {
"kind": "approval",
"id": "<string>"
},
"candidateCount": 123,
"consoleUrl": "<string>",
"actionTaken": "<string>",
"output": {},
"completionReason": "<string>",
"cancelReason": "due_date",
"assignee": "<string>"
}
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "forbidden",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "resource_missing",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "internal_error",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docUrl": "<string>",
"reason": "requester_unavailable",
"requiredPermission": "<string>",
"personRequired": true,
"decisionId": "<string>",
"capHeadroom": {
"remainingCents": 123,
"capCents": 123,
"consumedCents": 123,
"estimateCents": 123
},
"details": [
{
"path": "<string>",
"param": "<string>",
"message": "<string>",
"code": "required"
}
]
},
"meta": {
"requestId": "<string>",
"hasMore": true,
"nextCursor": "<string>",
"asOf": 123
}
}
