Set a bare tool call's content

JavaScript

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({
  apiKey: process.env['CADENYA_API_KEY'], // This is the default and can be omitted
});

const objectiveToolCall = await client.objectives.toolCalls.setContent(
  'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
  'toolcall_01HXKD2E5NQM3T9AYWCFTANFGV',
  {
    workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
    content: [
      {
        text: { text: 'text' },
        type: 'text',
      },
    ],
  },
);

console.log(objectiveToolCall.data);

import os
from cadenya import Cadenya

client = Cadenya(
    api_key=os.environ.get("CADENYA_API_KEY"),  # This is the default and can be omitted
)
objective_tool_call = client.objectives.tool_calls.set_content(
    objective_id="obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
    tool_call_id="toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
    workspace_id="workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    content=[{
        "text": {
            "text": "text"
        },
        "type": "text",
    }],
)
print(objective_tool_call.data)

package main

import (
	"context"
	"fmt"
	"go.cadenya.com/cadenya-go"
	"go.cadenya.com/cadenya-go/option"
)

func main() {
	client := cadenya.NewClient(
		option.WithAPIKey("My API Key"),
	)
	objectiveToolCall, err := client.Objectives.ToolCalls.SetContent(
		context.TODO(),
		"obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
		"toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
		cadenya.ObjectiveToolCallSetContentParams{
			WorkspaceID: cadenya.String("workspace_01HXKD2E5NQM3T9AYWCF133E3Q"),
			Content: []cadenya.SetToolCallContentRequestContentBlockUnionParam{{
				OfText: &cadenya.SetToolCallContentRequestContentBlockTextParam{
					Text: cadenya.SetToolCallContentRequestTextBlockParam{
						Text: "text",
					},
					Type: cadenya.SetToolCallContentRequestContentBlockTextTypeText,
				},
			}},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", objectiveToolCall.Data)
}

require "cadenya"

cadenya = Cadenya::Client.new(api_key: "My API Key")

objective_tool_call = cadenya.objectives.tool_calls.set_content(
  "obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
  "toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  content: [{text: {text: "text"}, type: :text}]
)

puts(objective_tool_call)

cadenya objectives:tool-calls set-content \
  --api-key 'My API Key' \
  --workspace-id workspace_01HXKD2E5NQM3T9AYWCF133E3Q \
  --objective-id obj_01HXKD2E5NQM3T9AYWCFQAZGFV \
  --tool-call-id toolcall_01HXKD2E5NQM3T9AYWCFTANFGV \
  --content '{text: {text: text}, type: text}'

curl --request POST \
  --url https://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": [
    {
      "type": "text",
      "text": {
        "text": "<string>"
      }
    }
  ]
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent",
  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([
    'content' => [
        [
                'type' => 'text',
                'text' => [
                                'text' => '<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://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": {\n        \"text\": \"<string>\"\n      }\n    }\n  ]\n}")
  .asString();

{
  "metadata": {
    "id": "<string>",
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "createdAt": "2023-11-07T05:31:56Z",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
    "labels": {},
    "externalId": "<string>"
  },
  "data": {
    "callable": {
      "type": "tool",
      "tool": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "createdAt": "2023-11-07T05:31:56Z",
        "externalId": "<string>",
        "labels": {},
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    },
    "arguments": {},
    "memo": "<string>",
    "statusChangedBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    },
    "resolvedSecrets": [
      {
        "key": "<string>"
      }
    ]
  },
  "info": {
    "objective": {
      "id": "<string>",
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "createdAt": "2023-11-07T05:31:56Z",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
      "labels": {},
      "externalId": "<string>"
    },
    "createdBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    },
    "tool": {
      "id": "<string>",
      "name": "<string>"
    },
    "toolSet": {
      "id": "<string>",
      "name": "<string>"
    }
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

POST

workspaces

{workspaceId}

objectives

{objectiveId}

tool_calls

{toolCallId}

:setContent

JavaScript

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({
  apiKey: process.env['CADENYA_API_KEY'], // This is the default and can be omitted
});

const objectiveToolCall = await client.objectives.toolCalls.setContent(
  'obj_01HXKD2E5NQM3T9AYWCFQAZGFV',
  'toolcall_01HXKD2E5NQM3T9AYWCFTANFGV',
  {
    workspaceId: 'workspace_01HXKD2E5NQM3T9AYWCF133E3Q',
    content: [
      {
        text: { text: 'text' },
        type: 'text',
      },
    ],
  },
);

console.log(objectiveToolCall.data);

import os
from cadenya import Cadenya

client = Cadenya(
    api_key=os.environ.get("CADENYA_API_KEY"),  # This is the default and can be omitted
)
objective_tool_call = client.objectives.tool_calls.set_content(
    objective_id="obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
    tool_call_id="toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
    workspace_id="workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    content=[{
        "text": {
            "text": "text"
        },
        "type": "text",
    }],
)
print(objective_tool_call.data)

package main

import (
	"context"
	"fmt"
	"go.cadenya.com/cadenya-go"
	"go.cadenya.com/cadenya-go/option"
)

func main() {
	client := cadenya.NewClient(
		option.WithAPIKey("My API Key"),
	)
	objectiveToolCall, err := client.Objectives.ToolCalls.SetContent(
		context.TODO(),
		"obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
		"toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
		cadenya.ObjectiveToolCallSetContentParams{
			WorkspaceID: cadenya.String("workspace_01HXKD2E5NQM3T9AYWCF133E3Q"),
			Content: []cadenya.SetToolCallContentRequestContentBlockUnionParam{{
				OfText: &cadenya.SetToolCallContentRequestContentBlockTextParam{
					Text: cadenya.SetToolCallContentRequestTextBlockParam{
						Text: "text",
					},
					Type: cadenya.SetToolCallContentRequestContentBlockTextTypeText,
				},
			}},
		},
	)
	if err != nil {
		panic(err.Error())
	}
	fmt.Printf("%+v\n", objectiveToolCall.Data)
}

require "cadenya"

cadenya = Cadenya::Client.new(api_key: "My API Key")

objective_tool_call = cadenya.objectives.tool_calls.set_content(
  "obj_01HXKD2E5NQM3T9AYWCFQAZGFV",
  "toolcall_01HXKD2E5NQM3T9AYWCFTANFGV",
  workspace_id: "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  content: [{text: {text: "text"}, type: :text}]
)

puts(objective_tool_call)

cadenya objectives:tool-calls set-content \
  --api-key 'My API Key' \
  --workspace-id workspace_01HXKD2E5NQM3T9AYWCF133E3Q \
  --objective-id obj_01HXKD2E5NQM3T9AYWCFQAZGFV \
  --tool-call-id toolcall_01HXKD2E5NQM3T9AYWCFTANFGV \
  --content '{text: {text: text}, type: text}'

curl --request POST \
  --url https://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": [
    {
      "type": "text",
      "text": {
        "text": "<string>"
      }
    }
  ]
}
'

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent",
  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([
    'content' => [
        [
                'type' => 'text',
                'text' => [
                                'text' => '<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://api.cadenya.com/v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": {\n        \"text\": \"<string>\"\n      }\n    }\n  ]\n}")
  .asString();

{
  "metadata": {
    "id": "<string>",
    "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
    "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
    "createdAt": "2023-11-07T05:31:56Z",
    "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
    "labels": {},
    "externalId": "<string>"
  },
  "data": {
    "callable": {
      "type": "tool",
      "tool": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "createdAt": "2023-11-07T05:31:56Z",
        "externalId": "<string>",
        "labels": {},
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    },
    "arguments": {},
    "memo": "<string>",
    "statusChangedBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    },
    "resolvedSecrets": [
      {
        "key": "<string>"
      }
    ]
  },
  "info": {
    "objective": {
      "id": "<string>",
      "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
      "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
      "createdAt": "2023-11-07T05:31:56Z",
      "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
      "labels": {},
      "externalId": "<string>"
    },
    "createdBy": {
      "metadata": {
        "id": "<string>",
        "accountId": "account_01HXKD2E5NQM3T9AYWCFTJHJVF",
        "name": "<string>",
        "profileId": "profile_01HXKD2E5NQM3T9AYWCFS0AP08",
        "externalId": "<string>",
        "labels": {},
        "createdAt": "2023-11-07T05:31:56Z"
      },
      "spec": {
        "email": "<string>",
        "name": "<string>"
      }
    },
    "tool": {
      "id": "<string>",
      "name": "<string>"
    },
    "toolSet": {
      "id": "<string>",
      "name": "<string>"
    }
  }
}

{
  "code": 123,
  "message": "<string>",
  "details": [
    {
      "@type": "<string>"
    }
  ]
}

A bare tool has no adapter. When an agent calls one, nothing fires: the tool call parks at TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT and waits for you to supply the result. That inversion is the point. The tool runs on your infrastructure, inside your VPC, against your database, and Cadenya only ever sees the answer.

The whole loop

// 1. Find the calls waiting on you.
const parked = await client.objectives.toolCalls.list(objectiveId, {
  workspaceId,
  executionStatus: 'TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT',
});

for await (const call of parked) {
  // 2. The agent's arguments, validated against your tool's JSON Schema.
  const { orderId } = call.data.arguments as { orderId: string };

  // 3. Run it wherever you like. Cadenya is not involved.
  const result = await db.orders.findOne({ orderId });

  // 4. Hand back the answer. The agent resumes.
  await client.objectives.toolCalls.setContent(call.metadata.id, {
    workspaceId,
    objectiveId,
    content: [{ type: 'text', text: { text: JSON.stringify(result) } }],
  });
}

// 1. Find the calls waiting on you.
parked := client.Objectives.ToolCalls.ListAutoPaging(ctx, objectiveID,
	cadenya.ObjectiveToolCallListParams{
		WorkspaceID:     cadenya.String(workspaceID),
		ExecutionStatus: cadenya.ObjectiveToolCallListParamsExecutionStatusToolCallExecutionStatusWaitingForContent,
	})

for parked.Next() {
	call := parked.Current()

	// 2. The agent's arguments, validated against your tool's JSON Schema.
	orderID := call.Data.Arguments["orderId"].(string)

	// 3. Run it wherever you like. Cadenya is not involved.
	result, err := db.Orders.FindOne(ctx, orderID)
	if err != nil {
		log.Fatal(err)
	}
	body, _ := json.Marshal(result)

	// 4. Hand back the answer. The agent resumes.
	_, err = client.Objectives.ToolCalls.SetContent(ctx, objectiveID, call.Metadata.ID,
		cadenya.ObjectiveToolCallSetContentParams{
			WorkspaceID: cadenya.String(workspaceID),
			Content: []cadenya.SetToolCallContentRequestContentBlockUnionParam{
				cadenya.SetToolCallContentRequestContentBlockParamOfText(
					cadenya.SetToolCallContentRequestTextBlockParam{Text: string(body)},
				),
			},
		})
}

# 1. Find the calls waiting on you.
parked = cadenya.objectives.tool_calls.list(
  objective_id,
  workspace_id: workspace_id,
  execution_status: :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT
)

parked.auto_paging_each do |call|
  # 2. The agent's arguments, validated against your tool's JSON Schema.
  order_id = call.data.arguments["orderId"]

  # 3. Run it wherever you like. Cadenya is not involved.
  result = db[:orders].first(order_id: order_id)

  # 4. Hand back the answer. The agent resumes.
  cadenya.objectives.tool_calls.set_content(
    call.metadata.id,
    workspace_id: workspace_id,
    objective_id: objective_id,
    content: [{type: :text, text: {text: result.to_json}}]
  )
end

# 1. Find the calls waiting on you.
curl "https://api.cadenya.com/v1/workspaces/${WORKSPACE_ID}/objectives/${OBJECTIVE_ID}/tool_calls?executionStatus=TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}"

# 2. Run the tool yourself, then hand back the answer. The agent resumes.
curl -X POST "https://api.cadenya.com/v1/workspaces/${WORKSPACE_ID}/objectives/${OBJECTIVE_ID}/tool_calls/${TOOL_CALL_ID}:setContent" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"content": [{"type": "text", "text": {"text": "{\"orderId\":\"A-1007\",\"status\":\"delivered\"}"}}]}'

That is a complete reverse harness. Poll, execute, answer.

What it looks like in flight

A real run, end to end. The agent decided to call lookup_order with the argument it extracted from the user’s message:

t+10s  toolcall_01KX1G6EBE9N9AVP2F33W0T0G7
       executionStatus: TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT
       arguments:       { "orderId": "A-1007" }
       objective state: STATE_RUNNING

The objective stays STATE_RUNNING while it waits. Then setContent lands with {"orderId":"A-1007","status":"delivered"}, and the agent picks up where it left off:

objective state:  STATE_FINALIZED
objective output: { "status": "delivered" }
tool call:        TOOL_CALL_EXECUTION_STATUS_COMPLETED

The response to setContent reports the call’s pre-update state: executionStatus still reads WAITING_FOR_CONTENT. The transition is asynchronous. Read the call back if you need the settled state, or watch for the agent’s next event.

Content is a list of blocks

content is required and takes at least one block. Each block is a discriminated union: type reads text, image, or audio, and the payload sits under the matching key.

content: [
  { type: 'text', text: { text: 'Order A-1007 shipped on 2026-07-01.' } },
  { type: 'image', image: { data: base64Png, mimeType: 'image/png' } },
]

Media blocks carry raw base64 data on input. On the way out, when you read the tool call back, media comes as a signed URL instead. The two shapes are deliberately different. The whole payload caps at 16 MiB. An empty array is a 400, and so is a block whose type does not match its payload key.

The two states that reject you

setContent is precondition-checked, and both failures are worth handling:

The tool call must be in WAITING_FOR_CONTENT. A call that already resumed, or was never bare, is a FailedPrecondition.
The objective must not be terminal. Setting content on a finalized or cancelled objective is a FailedPrecondition.

Setting content twice while still waiting is idempotent: the second call re-publishes rather than storing a second result.

Bound the wait

contentTimeout on the bare adapter decides how long a call may sit parked. It defaults to 24 hours, and when it elapses the call resolves on its own with a synthesized result:

<cadenya:system>No content was provided for this tool call before the timeout elapsed.</cadenya:system>

The objective keeps going rather than failing. That is a friendlier default than it sounds: a harness that dies mid-run leaves the agent able to reason about the absence of an answer instead of hanging forever.

Two patterns this unlocks

Human in the loop. The tool is a question for a person. Park the call, render the arguments in your app, and submit the human’s answer as the content. Unlike tool approval, which only gates a call Cadenya then makes itself, this lets the human be the tool. Reverse harness. The tool runs code that Cadenya cannot and should not reach: an internal service, a database behind a VPN, a GPU box, a legacy system with no HTTP surface. You poll, execute locally, and report back. There is no inbound network path from Cadenya to you, which is the whole reason a security team signs off. Both are the same three calls. The difference is only who computes the answer.

Create a tool set

The bare adapter, contentTimeout, and defining a tool by hand.

Approve a tool call

The other way to put a person between an agent and an action.

Stream objective events

Watch for the parked call instead of polling for it.

Create an agent

outputDefinition, which is what let this objective finalize.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workspaceId

string

required

Example:

"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"

objectiveId

string

required

The ID of the objective. Supports "external_id:" prefix for external IDs.

Example:

"obj_01HXKD2E5NQM3T9AYWCFQAZGFV"

toolCallId

string

required

The ID of the tool call to set content for

Example:

"toolcall_01HXKD2E5NQM3T9AYWCFTANFGV"

Body

application/json

SetToolCallContentRequest lets an external API consumer supply the result of a bare tool call (one whose tool set has no execution adapter). Used for human-in-the-loop tools and reverse harnesses that execute tools locally and report results back.

content

object[]

required

The content to set on the tool call. Mirrors ObjectiveToolCallResult.ContentBlock but writable: media blocks carry raw data on input where the result-side carries a signed url on output.

ContentBlock is a single block of tool call content supplied on input. Exactly one of the variants is set.

Option 1
Option 2
Option 3

Show child attributes

Response

ObjectiveToolCall is a record of a tool call made during an objective's execution. Tool calls are mutable — their status changes as they are approved, denied, or executed.

metadata

object

required

Metadata for ephemeral operations and activities (e.g., objectives, executions, runs)

Show child attributes

data

object

required

Show child attributes

status

enum<string>

required

Current status of the tool call

Available options:

TOOL_CALL_STATUS_UNSPECIFIED,

TOOL_CALL_STATUS_AUTO_APPROVED,

TOOL_CALL_STATUS_WAITING_FOR_APPROVAL,

TOOL_CALL_STATUS_APPROVED,

TOOL_CALL_STATUS_DENIED

executionStatus

enum<string>

required

read-only

Available options:

TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED,

TOOL_CALL_EXECUTION_STATUS_PENDING,

TOOL_CALL_EXECUTION_STATUS_RUNNING,

TOOL_CALL_EXECUTION_STATUS_COMPLETED,

TOOL_CALL_EXECUTION_STATUS_ERRORED,

TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT

info

object

Show child attributes

​The whole loop

​What it looks like in flight

​Content is a list of blocks

​The two states that reject you

​Bound the wait

​Two patterns this unlocks

​Related

Create a tool set

Approve a tool call

Stream objective events

Create an agent

Authorizations

Path Parameters

Body

Response

The whole loop

What it looks like in flight

Content is a list of blocks

The two states that reject you

Bound the wait

Two patterns this unlocks

Related