Introspect Tool

curl --request POST \
  --url https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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

fetch('https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect', 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://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect",
  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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect")

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

{
  "id": "7b2a1c34-5d6e-4f70-8a90-1b2c3d4e5f60",
  "organisation_id": "0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "name": "lookup_customer",
  "tool_type": "api_request",
  "config": {
    "type": "api_request",
    "url": "https://api.example.com/lookup",
    "http_method": "POST"
  },
  "description": "Look up a customer by id",
  "declared_secrets": [],
  "dependencies": [],
  "argument_defaults": {},
  "code_src": null,
  "last_run_status": "succeeded",
  "source": "org",
  "latest_version": 3,
  "content_hash": "3f1ab2c4d5e6f708",
  "is_current_hash_green": true,
  "is_current_version": true,
  "schema_stale": false,
  "gate_status": {
    "static": {
      "config_valid": {
        "passed": true
      },
      "secrets_exist": {
        "passed": true
      },
      "name_unique": {
        "passed": true
      }
    },
    "green_run": {
      "passed": true
    }
  }
}

POST

agents

tools

{tool_id}

introspect

Introspect Tool

curl --request POST \
  --url https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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

fetch('https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect', 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://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect",
  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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.agents.slng.ai/v1/agents/tools/{tool_id}/introspect")

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

{
  "id": "7b2a1c34-5d6e-4f70-8a90-1b2c3d4e5f60",
  "organisation_id": "0a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
  "name": "lookup_customer",
  "tool_type": "api_request",
  "config": {
    "type": "api_request",
    "url": "https://api.example.com/lookup",
    "http_method": "POST"
  },
  "description": "Look up a customer by id",
  "declared_secrets": [],
  "dependencies": [],
  "argument_defaults": {},
  "code_src": null,
  "last_run_status": "succeeded",
  "source": "org",
  "latest_version": 3,
  "content_hash": "3f1ab2c4d5e6f708",
  "is_current_hash_green": true,
  "is_current_version": true,
  "schema_stale": false,
  "gate_status": {
    "static": {
      "config_valid": {
        "passed": true
      },
      "secrets_exist": {
        "passed": true
      },
      "name_unique": {
        "passed": true
      }
    },
    "green_run": {
      "passed": true
    }
  }
}

Authorizations

Authorization

string

header

required

Your SLNG consumer API key.

Path Parameters

tool_id

string<uuid>

required

The tool UUID. Curated tools are visible but read-only, and a tool owned by another organisation returns 404.

Response

The tool after its Custom Code draft is built and validated, including the input and output argument schemas derived from the code.

A tool and its current draft state, including config, publish gates, and version info.

string<uuid>

required

organisation_id

string<uuid>

required

name

string

required

description

string

required

declared_secrets

string[]

required

Vault secret names this tool is allowed to read at runtime.

dependencies

string[]

required

Pinned Python package dependencies installed for this tool.

source

enum<string>

required

curated tools are built in and maintained by SLNG; org tools were created by your organisation.

Available options:

curated,

org

content_hash

string

required

is_current_hash_green

boolean

required

is_current_version

boolean

required

schema_stale

boolean

required

gate_status

GateStatus · object

required

Gate set is selected by tool_type (V2): data → static + green_run; code also reports config_valid; ctx-bound → config_valid ONLY.

Show child attributes

tool_type

enum<string>

default:code

Available options:

code,

api_request,

end_call,

voicemail_detection,

transfer_call,

send_sms,

current_datetime,

user_phone_number

config

CodeConfig · object

Configuration for a Custom Code tool. Custom code runs sandboxed with no internet access.

Show child attributes

argument_defaults

Argument Defaults · object

Current default values for the tool arguments, keyed by argument name. Each value is a literal (string, number, or boolean) or a Vault variable reference using the {{$NAME}} syntax. Applied when a caller does not supply that argument.

code_src

string | null

Current Python source for the tool, populated for Custom Code tools only. Custom Code runs sandboxed with no internet access.

last_run_status

string | null

latest_version

integer | null

arg_schema

Arg Schema · object | null

⌘I

Overview

Unified API

Text-to-Speech

Speech-to-Text

Managed Agents

Agent resources

Batch

Account

Bridges

Introspect Tool

Authorizations

Path Parameters

Response