Refresh and validate Computer Agent helpers
Rebuilds the selected Computer Agent's helper registration from the helper source files in its installed skills, then validates the registered contracts and source files. Run this after creating or changing a helper. A successful refresh means the helper is registered and its source passed validation; list the helpers and execute a representative request before making the helper available to conversations.
OpenAPI
````yaml post /api/v2/computer/accounts/{targetAccountId}/helpers/refresh
openapi: 3.0.0
info:
version: 2.0.0
title: GetVoiceBot API
description: GetVoiceBot API Documentation
servers:
- url: https://api.getvoicebot.com
description: GetVoiceBot Production
variables:
baseUrl:
default: api.getvoicebot.com
description: Production API Root
security: []
tags:
- name: Agents
- name: Inbound Email
description: Control which senders may create inbound email work for an Agent.
- name: Features
description: Inspect capabilities available within an account hierarchy.
- name: Conversation Logs
description: Query conversation activity and calculate account-level metrics.
- name: Computer Agents
description: Set up, configure, inspect, and manage GetVoiceBot Computer Agents.
- name: Computer Agent Sessions
description: View and reset Computer Agent sessions.
- name: Accounts
- name: Agent Templates
description: Create, manage, and apply reusable Agent configurations.
paths:
/api/v2/computer/accounts/{targetAccountId}/helpers/refresh:
post:
tags:
- Computer Agents
summary: Refresh and validate Computer Agent helpers
description: >
Rebuilds the selected Computer Agent's helper registration from the
helper source files in its installed skills, then validates the
registered contracts and source files. Run this after creating or
changing a helper. A successful refresh means the helper is registered
and its source passed validation; list the helpers and execute a
representative request before making the helper available to
conversations.
operationId: helpersPostRefresh
parameters:
- name: targetAccountId
in: path
required: true
description: ''
schema:
type: string
responses:
'200':
description: Helper registration and validation result
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
ok:
type: boolean
status:
type: string
enum:
- done
- failed
agentId:
type: string
functions:
type: array
items:
type: object
required:
- name
- description
- args
- result
- requiresBrowser
- requiredSecrets
properties:
name:
type: string
domain:
type: string
description:
type: string
args:
type: object
additionalProperties: true
result:
type: object
additionalProperties: true
source:
type: string
skillSlug:
type: string
nullable: true
requiresBrowser:
type: boolean
requiredSecrets:
type: array
items:
type: string
validation:
type: object
required:
- compile
- missingExports
- staleRegistryEntries
- missingRegistryEntries
- errors
properties:
compile:
type: array
items:
type: object
required:
- path
- ok
properties:
path:
type: string
ok:
type: boolean
error:
type: string
nullable: true
missingExports:
type: array
items:
type: string
staleRegistryEntries:
type: array
items:
type: string
missingRegistryEntries:
type: array
items:
type: string
errors:
type: array
items:
type: string
required:
- ok
- status
- agentId
- functions
- validation
security:
- apiKeyAuth: []
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: query
name: token
description: GetVoiceBot API Token
````
