Start a skill authentication action

Starts one sign-in action returned by the latest skill verification. The response uses the same session fields as the sign-in status endpoint. Poll status until it returns a user handoff or a terminal result.

OpenAPI

````yaml post /api/v2/computer/accounts/{targetAccountId}/skills/{skillSlug}/auth/{actionId}/start
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}/skills/{skillSlug}/auth/{actionId}/start:
post:
tags:
- Computer Agents
summary: Start a skill authentication action
description: >
Starts one sign-in action returned by the latest skill verification. The
response uses the same session fields as the sign-in status endpoint.
Poll status until it returns a user handoff or a terminal result.
operationId: authPostStart
parameters:
- name: targetAccountId
in: path
required: true
description: ''
schema:
type: string
- name: skillSlug
in: path
required: true
description: ''
schema:
type: string
- name: actionId
in: path
required: true
description: ''
schema:
type: string
responses:
'200':
description: Skill sign-in started
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
result:
type: object
required:
- skillSlug
- actionId
- session
properties:
skillSlug:
type: string
actionId:
type: string
session:
type: object
required:
- actionId
- status
properties:
actionId:
type: string
jobId:
type: string
nullable: true
status:
type: string
enum:
- queued
- launching
- running
- browser_ready
- waiting_for_user
- succeeded
- failed
- cancelling
- cancelled
- unknown
phase:
type: string
nullable: true
browserNavigateUrl:
type: string
format: uri
nullable: true
capturedDeviceCode:
type: string
nullable: true
error:
type: object
nullable: true
additionalProperties: true
required:
- result
security:
- apiKeyAuth: []
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: query
name: token
description: GetVoiceBot API Token

````