Agent Runs

Continue a run after its approvers decided

Continues the agent run a held tool call belongs to, once the approvers the organization’s tool policy names have decided every held call of that run in the approval queue. Call it after recording a decision there; this endpoint records none and takes no body. The caller must be able to read the approval: the caller whose run was held, or one of its approvers signed in to the same organization. Otherwise the answer is 404 with error code tool_approval_not_found. A held call that no agent run made returns 404 with error code not_an_agent_run. While any call of the run is undecided, including one without approvers that only the run’s caller can decide, the answer has status waiting and creates nothing. Once all are decided, one continuation run is created with the identity of the run’s caller and carries out each recorded decision; expired approvals are left out. Repeating the request, or two approvers finishing together, returns the same continuation run. When every approval has expired the answer is 409 with error code tool_approval_expired. The continuation is an ordinary run of the agent: it is not delivered to the connector conversation or web chat session that started the held run.

POST

api

agents

tool-approvals

{approval_request_id}

resume

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.AgentRuns.ResumeAgentRunToolApprovalAsync(approvalRequestId: "<id>");

// handle response

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.agent_runs.resume_agent_run_tool_approval(approval_request_id="<id>")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.agentRuns.resumeAgentRunToolApproval({
    approvalRequestId: "<id>",
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.AgentRuns.ResumeAgentRunToolApproval(ctx, "<id>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunApprovalResume != nil {
        // handle response
    }
}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume', 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://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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;
}

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "agent.run.approval_resume",
  "status": "waiting",
  "source_run_id": "<string>",
  "pending": 2,
  "continuation_run": {
    "object": "agent.run",
    "id": "<string>",
    "agent_id": "<string>",
    "agent_version": 2,
    "status": "waiting",
    "input": "<unknown>",
    "conversation": "<unknown>",
    "previous_response_id": "<string>",
    "metadata": {},
    "gateway_response_id": "<string>",
    "gateway_response": "<unknown>",
    "error": "<unknown>",
    "pending_approvals": [
      {
        "id": "<string>",
        "kind": "mcp_approval_request",
        "tool_type": "<string>",
        "name": "<string>",
        "server_label": "<string>",
        "arguments": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Headers

X-On-Behalf-Of

string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

approval_request_id

string

required

ID of a held tool call, as the approval queue lists it.

Response

The run is still waiting for decisions, or was continued.

object

enum<string>

required

Available options:

agent.run.approval_resume

status

enum<string>

required

waiting while a held call of the run is undecided, with the count in pending; resumed once the run was continued, with the new run in continuation_run.

Available options:

waiting,

resumed

source_run_id

string

required

The run that stopped for approval.

pending

integer

How many held calls of the run are undecided. Present when status is waiting.

Required range: x >= 1

continuation_run

object

Show child attributes

⌘I

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.AgentRuns.ResumeAgentRunToolApprovalAsync(approvalRequestId: "<id>");

// handle response

from meetkai_mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.agent_runs.resume_agent_run_tool_approval(approval_request_id="<id>")

    # Handle response
    print(res)

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  const result = await sdk.agentRuns.resumeAgentRunToolApproval({
    approvalRequestId: "<id>",
  });

  console.log(result);
}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.AgentRuns.ResumeAgentRunToolApproval(ctx, "<id>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunApprovalResume != nil {
        // handle response
    }
}

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume', 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://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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;
}

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/tool-approvals/{approval_request_id}/resume")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "agent.run.approval_resume",
  "status": "waiting",
  "source_run_id": "<string>",
  "pending": 2,
  "continuation_run": {
    "object": "agent.run",
    "id": "<string>",
    "agent_id": "<string>",
    "agent_version": 2,
    "status": "waiting",
    "input": "<unknown>",
    "conversation": "<unknown>",
    "previous_response_id": "<string>",
    "metadata": {},
    "gateway_response_id": "<string>",
    "gateway_response": "<unknown>",
    "error": "<unknown>",
    "pending_approvals": [
      {
        "id": "<string>",
        "kind": "mcp_approval_request",
        "tool_type": "<string>",
        "name": "<string>",
        "server_label": "<string>",
        "arguments": "<string>"
      }
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "completed_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "details": "<unknown>"
  }
}

Overview

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Continue a run after its approvers decided

Authorizations

Headers

Path Parameters

Response