Agent Runs

Approve or deny a run's pending tool calls

Answers the approval requests a run stopped for and creates the run that continues it. A run that stopped for approval has status completed and lists the held calls in pending_approvals: an mcp_approval_request for an MCP tool call, a tool_approval_request for a built-in tool call the organization’s tool policy holds. Send one decision as the body itself, or several under decisions. One request must decide every pending approval of the run, because the calls left out can never be answered afterwards; otherwise the answer is 409 with error code approvals_incomplete. An expired approval needs no decision and is left out of the continuation. The decision is single-use and bound to the original tool and arguments; a denied call never runs. When the tool policy names approvers for a call, only they decide it, in the approval queue: until one has, the answer is 409 with error code tool_approval_pending, and a decision that differs from the approver’s is 409 with error code tool_approval_decision_mismatch. Decisions that pass these checks and are still refused show as a failed continuation run whose error.code is one of those two codes. A run whose approvals were already answered returns 409 with error code approvals_already_answered. Only the caller whose run was held can answer it; a teammate who can read the run gets 403 with error code not_run_caller. API-key callers also need read:responses, which reading the approvals requires.

POST

api

agents

{agent_id}

runs

{run_id}

mcp-approvals

CSharp (SDK)

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

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

var res = await sdk.AgentRuns.DecideAgentRunMcpApprovalAsync(
    agentId: "<id>",
    runId: "<id>",
    body: DecideAgentRunMcpApprovalRequestBody.CreateDecideAgentRunMcpApprovalRequest(
        new MeetKai.MKA1.Types.Components.DecideAgentRunMcpApprovalRequest() {
            ApprovalRequestId = "<id>",
            Approve = false,
        }
    )
);

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_runs.decide_agent_run_mcp_approval(agent_id="<id>", run_id="<id>", body={
        "approval_request_id": "<id>",
        "approve": False,
    })

    # 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.decideAgentRunMcpApproval({
    agentId: "<id>",
    runId: "<id>",
    requestBody: {
      approvalRequestId: "<id>",
      approve: false,
    },
  });

  console.log(result);
}

run();

package main

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

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

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

    res, err := s.AgentRuns.DecideAgentRunMcpApproval(ctx, "<id>", "<id>", operations.CreateDecideAgentRunMcpApprovalRequestBodyDecideAgentRunMcpApprovalRequest(
        components.DecideAgentRunMcpApprovalRequest{
            ApprovalRequestID: "<id>",
            Approve: false,
        },
    ), nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunMcpApproval != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approval_request_id": "<string>",
  "approve": true,
  "reason": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({approval_request_id: '<string>', approve: true, reason: '<string>'})
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals', 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/{agent_id}/runs/{run_id}/mcp-approvals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'approval_request_id' => '<string>',
    'approve' => true,
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"approval_request_id\": \"<string>\",\n  \"approve\": true,\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"approval_request_id\": \"<string>\",\n  \"approve\": true,\n  \"reason\": \"<string>\"\n}"

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

{
  "object": "agent.run.mcp_approval",
  "approval_request_id": "<string>",
  "approved": true,
  "source_run_id": "<string>",
  "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"
  },
  "decisions": [
    {
      "approval_request_id": "<string>",
      "approve": true,
      "reason": "<string>"
    }
  ]
}

{
  "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

agent_id

string

required

run_id

string

required

Body

application/json

Option 1
Option 2

approval_request_id

string

required

Minimum string length: 1

approve

boolean

required

reason

string

Required string length: 1 - 2000

Response

Decisions accepted and continuation run created.

object

enum<string>

required

Available options:

agent.run.mcp_approval

approval_request_id

string

required

The first decision's approval request. Kept for clients that send one decision.

approved

boolean

required

The first decision.

source_run_id

string

required

continuation_run

object

required

Show child attributes

decisions

object[]

Every decision the continuation run carries. Decisions for expired approvals are left out.

Show child attributes

⌘I

CSharp (SDK)

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

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

var res = await sdk.AgentRuns.DecideAgentRunMcpApprovalAsync(
    agentId: "<id>",
    runId: "<id>",
    body: DecideAgentRunMcpApprovalRequestBody.CreateDecideAgentRunMcpApprovalRequest(
        new MeetKai.MKA1.Types.Components.DecideAgentRunMcpApprovalRequest() {
            ApprovalRequestId = "<id>",
            Approve = false,
        }
    )
);

// handle response

from meetkai_mka1 import SDK


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

    res = sdk.agent_runs.decide_agent_run_mcp_approval(agent_id="<id>", run_id="<id>", body={
        "approval_request_id": "<id>",
        "approve": False,
    })

    # 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.decideAgentRunMcpApproval({
    agentId: "<id>",
    runId: "<id>",
    requestBody: {
      approvalRequestId: "<id>",
      approve: false,
    },
  });

  console.log(result);
}

run();

package main

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

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

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

    res, err := s.AgentRuns.DecideAgentRunMcpApproval(ctx, "<id>", "<id>", operations.CreateDecideAgentRunMcpApprovalRequestBodyDecideAgentRunMcpApprovalRequest(
        components.DecideAgentRunMcpApprovalRequest{
            ApprovalRequestID: "<id>",
            Approve: false,
        },
    ), nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.AgentRunMcpApproval != nil {
        // handle response
    }
}

curl --request POST \
  --url https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "approval_request_id": "<string>",
  "approve": true,
  "reason": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({approval_request_id: '<string>', approve: true, reason: '<string>'})
};

fetch('https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals', 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/{agent_id}/runs/{run_id}/mcp-approvals",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'approval_request_id' => '<string>',
    'approve' => true,
    'reason' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"approval_request_id\": \"<string>\",\n  \"approve\": true,\n  \"reason\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/agents/{agent_id}/runs/{run_id}/mcp-approvals")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"approval_request_id\": \"<string>\",\n  \"approve\": true,\n  \"reason\": \"<string>\"\n}"

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

{
  "object": "agent.run.mcp_approval",
  "approval_request_id": "<string>",
  "approved": true,
  "source_run_id": "<string>",
  "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"
  },
  "decisions": [
    {
      "approval_request_id": "<string>",
      "approve": true,
      "reason": "<string>"
    }
  ]
}

{
  "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

Approve or deny a run's pending tool calls

Authorizations

Headers

Path Parameters

Body

Response