curl --request PATCH \
--url https://guidinghand.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"instructions": "<string>",
"greeting": "<string>",
"display_name": "<string>",
"narration": true,
"customer_answers": true,
"customer_approvals": true
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
instructions: '<string>',
greeting: '<string>',
display_name: '<string>',
narration: true,
customer_answers: true,
customer_approvals: true
})
};
fetch('https://guidinghand.ai/v1/agents/{agent_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guidinghand.ai/v1/agents/{agent_id}"
payload = {
"name": "<string>",
"instructions": "<string>",
"greeting": "<string>",
"display_name": "<string>",
"narration": True,
"customer_answers": True,
"customer_approvals": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"object": "agent",
"agent_id": "billing",
"name": "Billing help",
"instructions": "<string>",
"effort": "low",
"greeting": "<string>",
"display_name": "Acme Support",
"narration": true,
"customer_answers": true,
"customer_approvals": true,
"is_default": true,
"invite_url_template": "https://guidinghand.ai/acme/billing/{code}",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}Update an agent
Send only the fields to change.
curl --request PATCH \
--url https://guidinghand.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"instructions": "<string>",
"greeting": "<string>",
"display_name": "<string>",
"narration": true,
"customer_answers": true,
"customer_approvals": true
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: '<string>',
instructions: '<string>',
greeting: '<string>',
display_name: '<string>',
narration: true,
customer_answers: true,
customer_approvals: true
})
};
fetch('https://guidinghand.ai/v1/agents/{agent_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://guidinghand.ai/v1/agents/{agent_id}"
payload = {
"name": "<string>",
"instructions": "<string>",
"greeting": "<string>",
"display_name": "<string>",
"narration": True,
"customer_answers": True,
"customer_approvals": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"object": "agent",
"agent_id": "billing",
"name": "Billing help",
"instructions": "<string>",
"effort": "low",
"greeting": "<string>",
"display_name": "Acme Support",
"narration": true,
"customer_answers": true,
"customer_approvals": true,
"is_default": true,
"invite_url_template": "https://guidinghand.ai/acme/billing/{code}",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}{
"error": {
"type": "invalid_request",
"message": "<string>",
"code": "<string>",
"answered_by": "customer"
}
}Authorizations
An org API key (gh_live_…) from Settings → API keys in the console.
Path Parameters
The agent’s id, e.g. billing or default.
Body
8020000How much the model thinks per step. Null for GuidingHand’s default.
low, medium, high, null 500What the app calls the agent on the person’s screen, in place of “GuidingHand”. One line; empty goes back to “GuidingHand”.
40Show the agent’s thoughts and steps on the person’s screen as it works, and its summary when it finishes. Off: the banner with the Stop button only (and the agent’s questions and approval requests, if customer_answers and customer_approvals are on).
Let the person at the computer answer the agent’s questions in the GuidingHand app.
Let the person at the computer approve or deny the agent’s approval requests in the GuidingHand app.
Response
OK
"billing"
"Billing help"
Added under GuidingHand’s own rules, which always win.
How much the model thinks per step. Null for GuidingHand’s default.
low, medium, high, null Shown to the person on the invite page.
What the GuidingHand app calls the agent on the person’s screen while it works (“Acme Support is typing”). Empty means “GuidingHand”.
"Acme Support"
The app shows the agent’s thoughts and steps on the person’s screen as it works, and its summary when it finishes. These are the agent’s own words, so they can repeat what your team answered. Off: no thoughts, steps or summary; they see the banner with the Stop button (and the agent’s questions and approval requests, if customer_answers and customer_approvals are on).
The person at the computer can answer the agent’s questions in the GuidingHand app (your team still can too; the first answer is used). Off: only your team answers, and the question isn’t shown on the person’s screen.
The person at the computer can approve or deny the agent’s approval requests in the GuidingHand app (your team still can too; the first decision is used). Off: only your team decides, and the request isn’t shown on the person’s screen.
"https://guidinghand.ai/acme/billing/{code}"