> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://platform.bctrl.ai/llms.txt. > For full documentation content, see https://platform.bctrl.ai/llms-full.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server. # Create a durable invocation for a live runtime POST https://api.bctrl.ai/v2/runtimes/{runtimeId}/invocations Content-Type: application/json Submit durable AI work to a live runtime using the simplified v2 invocation contract. Reference: https://platform.bctrl.ai/v2/api/api-reference/runtimes/v-2-runtimes-invocations-create ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: bctrl API version: 1.0.0 paths: /v2/runtimes/{runtimeId}/invocations: post: operationId: v-2-runtimes-invocations-create summary: Create a durable invocation for a live runtime description: >- Submit durable AI work to a live runtime using the simplified v2 invocation contract. tags: - subpackage_runtimes parameters: - name: runtimeId in: path required: true schema: type: string - name: Authorization in: header description: Use Bearer . required: true schema: type: string responses: '202': description: Default Response content: application/json: schema: $ref: >- #/components/schemas/runtimes_v2.runtimes.invocations.create_Response_202 requestBody: content: application/json: schema: $ref: >- #/components/schemas/runtimes_v2.runtimes.invocations.create_Request servers: - url: https://api.bctrl.ai description: Production - url: http://localhost:8787 description: Local development gateway components: schemas: V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input0: type: object properties: instruction: type: string timeoutMs: type: integer required: - instruction title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0InputOneOf1Action: type: object properties: arguments: type: array items: type: string description: type: string method: type: string selector: type: string required: - description - selector title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0InputOneOf1Action V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input1: type: object properties: action: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0InputOneOf1Action timeoutMs: type: integer required: - action title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0TargetPage: type: string enum: - active - new title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0TargetPage V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Target: type: object properties: page: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0TargetPage type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Target RuntimesV2RuntimesInvocationsCreateRequest0: type: object properties: idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Metadata method: type: string enum: - act provider: type: string enum: - stagehand target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf0Target required: - input - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Input: type: object properties: instruction: type: string selector: type: string timeoutMs: type: integer required: - instruction title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1TargetPage: type: string enum: - active - new title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1TargetPage V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Target: type: object properties: page: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1TargetPage type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Target RuntimesV2RuntimesInvocationsCreateRequest1: type: object properties: idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Metadata method: type: string enum: - observe provider: type: string enum: - stagehand target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf1Target required: - input - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Input: type: object properties: instruction: type: string selector: type: string timeoutMs: type: integer title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2TargetPage: type: string enum: - active - new title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2TargetPage V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Target: type: object properties: page: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2TargetPage type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Target RuntimesV2RuntimesInvocationsCreateRequest2: type: object properties: idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Metadata method: type: string enum: - extract outputSchema: type: object additionalProperties: description: Any type provider: type: string enum: - stagehand target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf2Target required: - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest2 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel0: type: object properties: connection: type: string model: type: string required: - connection title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModelOneOf1Provider: type: string enum: - openai - anthropic - google title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModelOneOf1Provider V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel1: type: object properties: apiKey: type: string model: type: string provider: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModelOneOf1Provider required: - apiKey - model - provider title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel0: type: object properties: connection: type: string model: type: string required: - connection title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModelOneOf1Provider: type: string enum: - openai - anthropic - google title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModelOneOf1Provider V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel1: type: object properties: apiKey: type: string model: type: string provider: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModelOneOf1Provider required: - apiKey - model - provider title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Config: type: object properties: executionModel: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigExecutionModel model: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3ConfigModel systemPrompt: type: string title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Config V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems0: type: object properties: name: type: string storagePath: type: string required: - storagePath title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems1: type: object properties: fileId: type: string format: uuid name: type: string required: - fileId title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3InputVariables: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3InputVariables V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Input: type: object properties: instruction: type: string maxSteps: type: integer timeoutMs: type: integer variables: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3InputVariables required: - instruction title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Options: type: object properties: highlightCursor: type: boolean title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Options V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3TargetPage: type: string enum: - active - new title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3TargetPage V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Target: type: object properties: page: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3TargetPage type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Target RuntimesV2RuntimesInvocationsCreateRequest3: type: object properties: config: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Config files: type: array items: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3FilesItems idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Metadata method: type: string enum: - agent options: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Options outputSchema: type: object additionalProperties: description: Any type provider: type: string enum: - stagehand target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf3Target toolsetId: type: string format: uuid required: - input - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest3 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm0: type: object properties: connection: type: string model: type: string required: - connection title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlmOneOf1Provider: type: string enum: - openai - anthropic - google title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlmOneOf1Provider V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm1: type: object properties: apiKey: type: string model: type: string provider: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlmOneOf1Provider required: - apiKey - model - provider title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigGenerateGif: oneOf: - type: boolean - type: string title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigGenerateGif V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm0: type: object properties: connection: type: string model: type: string required: - connection title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlmOneOf1Provider: type: string enum: - openai - anthropic - google title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlmOneOf1Provider V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm1: type: object properties: apiKey: type: string model: type: string provider: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlmOneOf1Provider required: - apiKey - model - provider title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm0: type: object properties: connection: type: string model: type: string required: - connection title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlmOneOf1Provider: type: string enum: - openai - anthropic - google title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlmOneOf1Provider V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm1: type: object properties: apiKey: type: string model: type: string provider: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlmOneOf1Provider required: - apiKey - model - provider title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigSensitiveData: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigSensitiveData V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigUseVision: oneOf: - type: boolean - type: string enum: - auto title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigUseVision V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigVisionDetailLevel: type: string enum: - low - high - auto title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigVisionDetailLevel V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Config: type: object properties: calculateCost: type: boolean directlyOpenUrl: type: boolean displayFilesInDoneText: type: boolean enablePlanning: type: boolean extendSystemMessage: type: string fallbackLlm: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigFallbackLlm finalResponseAfterFailure: type: boolean flashMode: type: boolean generateGif: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigGenerateGif groundTruth: type: string includeAttributes: type: array items: type: string includeRecentEvents: type: boolean includeToolCallExamples: type: boolean initialActions: type: array items: description: Any type llm: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigLlm llmScreenshotSize: type: array items: description: Any type llmTimeout: type: number format: double loopDetectionEnabled: type: boolean loopDetectionWindow: type: integer maxActionsPerStep: type: integer maxClickableElementsLength: type: integer maxFailures: type: integer maxHistoryItems: type: - integer - 'null' maxSteps: type: integer messageCompaction: type: boolean overrideSystemMessage: type: string pageExtractionLlm: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigPageExtractionLlm planningExplorationLimit: type: integer planningReplanOnStall: type: integer pricingUrl: type: string saveConversationPath: type: string saveConversationPathEncoding: type: string sensitiveData: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigSensitiveData source: type: string stepTimeout: type: number format: double useJudge: type: boolean useThinking: type: boolean useVision: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigUseVision visionDetailLevel: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4ConfigVisionDetailLevel title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Config V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems0: type: object properties: name: type: string storagePath: type: string required: - storagePath title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems0 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems1: type: object properties: fileId: type: string format: uuid name: type: string required: - fileId title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems1 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems0 - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems1 title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Input: type: object properties: instruction: type: string maxSteps: type: integer required: - instruction title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Options: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Options V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4TargetPage: type: string enum: - active - new title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4TargetPage V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Target: type: object properties: page: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4TargetPage type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Target RuntimesV2RuntimesInvocationsCreateRequest4: type: object properties: config: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Config files: type: array items: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4FilesItems idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Metadata method: type: string enum: - agent options: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Options outputSchema: type: object additionalProperties: description: Any type provider: type: string enum: - browserUse target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf4Target toolsetId: type: string format: uuid required: - input - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest4 V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Input: type: object properties: scope: type: string enum: - active_page timeoutMs: type: integer title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Input V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Metadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Metadata V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Target: type: object properties: page: type: string enum: - active type: type: string enum: - browser_page required: - page - type title: >- V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Target RuntimesV2RuntimesInvocationsCreateRequest5: type: object properties: idempotencyKey: type: string input: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Input metadata: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Metadata method: type: string enum: - solveCaptcha provider: type: string enum: - bctrl target: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostRequestBodyContentApplicationJsonSchemaOneOf5Target required: - method - provider title: RuntimesV2RuntimesInvocationsCreateRequest5 runtimes_v2.runtimes.invocations.create_Request: oneOf: - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest0' - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest1' - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest2' - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest3' - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest4' - $ref: '#/components/schemas/RuntimesV2RuntimesInvocationsCreateRequest5' title: runtimes_v2.runtimes.invocations.create_Request V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataErrorDetails: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataErrorDetails V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataError: type: object properties: code: type: string details: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataErrorDetails message: type: string required: - message title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataError V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataMetadata: type: object properties: {} title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataMetadata V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataProgress: type: object properties: message: type: string step: type: integer totalSteps: type: integer title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataProgress Schema13: type: array items: $ref: '#/components/schemas/__schema1' title: Schema13 Schema1: oneOf: - type: string - type: number format: double - type: boolean - $ref: '#/components/schemas/Schema13' - type: object additionalProperties: description: Any type title: Schema1 __schema1: oneOf: - $ref: '#/components/schemas/Schema1' - type: 'null' title: __schema1 V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataRuntimeType: type: string enum: - browser - desktop - spreadsheet title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataRuntimeType V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataStatus: type: string enum: - queued - dispatching - running - cancelling - succeeded - failed - cancelled - timed_out title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataStatus V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaData: type: object properties: artifactCount: type: integer createdAt: type: string durationMs: type: - integer - 'null' error: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataError - type: 'null' finishedAt: type: - string - 'null' id: type: string format: uuid metadata: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataMetadata - type: 'null' progress: oneOf: - $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataProgress - type: 'null' result: oneOf: - $ref: '#/components/schemas/__schema1' - type: 'null' runId: type: string format: uuid runtimeId: type: string format: uuid runtimeType: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataRuntimeType spaceId: type: string format: uuid startedAt: type: - string - 'null' status: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaDataStatus type: type: string required: - artifactCount - createdAt - id - runId - runtimeId - runtimeType - spaceId - status - type title: >- V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaData runtimes_v2.runtimes.invocations.create_Response_202: type: object properties: data: $ref: >- #/components/schemas/V2RuntimesRuntimeIdInvocationsPostResponsesContentApplicationJsonSchemaData required: - data title: runtimes_v2.runtimes.invocations.create_Response_202 securitySchemes: bearerAuth: type: http scheme: bearer description: Use Bearer . ``` ## Examples **Request** ```json { "input": { "instruction": "string" }, "method": "string", "provider": "string" } ``` **Response** ```json { "data": { "artifactCount": 1, "createdAt": "string", "id": "string", "runId": "string", "runtimeId": "string", "runtimeType": "browser", "spaceId": "string", "status": "queued", "type": "string", "durationMs": 1, "error": { "message": "string", "code": "string", "details": {} }, "finishedAt": "string", "metadata": {}, "progress": { "message": "string", "step": 1, "totalSteps": 1 }, "result": {}, "startedAt": "string" } } ``` **SDK Code** ```python import requests url = "https://api.bctrl.ai/v2/runtimes/runtimeId/invocations" payload = { "input": { "instruction": "string" }, "method": "string", "provider": "string" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.bctrl.ai/v2/runtimes/runtimeId/invocations'; const options = { method: 'POST', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"input":{"instruction":"string"},"method":"string","provider":"string"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.bctrl.ai/v2/runtimes/runtimeId/invocations" payload := strings.NewReader("{\n \"input\": {\n \"instruction\": \"string\"\n },\n \"method\": \"string\",\n \"provider\": \"string\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.bctrl.ai/v2/runtimes/runtimeId/invocations") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"input\": {\n \"instruction\": \"string\"\n },\n \"method\": \"string\",\n \"provider\": \"string\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.bctrl.ai/v2/runtimes/runtimeId/invocations") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"input\": {\n \"instruction\": \"string\"\n },\n \"method\": \"string\",\n \"provider\": \"string\"\n}") .asString(); ``` ```php request('POST', 'https://api.bctrl.ai/v2/runtimes/runtimeId/invocations', [ 'body' => '{ "input": { "instruction": "string" }, "method": "string", "provider": "string" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.bctrl.ai/v2/runtimes/runtimeId/invocations"); var request = new RestRequest(Method.POST); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"input\": {\n \"instruction\": \"string\"\n },\n \"method\": \"string\",\n \"provider\": \"string\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "input": ["instruction": "string"], "method": "string", "provider": "string" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.bctrl.ai/v2/runtimes/runtimeId/invocations")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```