Resolve a task to one tool, its operation and an example call, with a…

/v1/discovery/resolve

Not yet described in the overlay (TI-20).

Authorizations

Authorizationstringheaderrequired

Bearer token: Authorization: Bearer ozk_…. ozk_ platform API key (Authorization: Bearer ozk_…)

Body

application/json

taskstringrequired

What you want done, in plain language

kindsstring[]

Card types to consider (agent, workflow, connector, mcp_server, skill, plugin, …); plural kinds are accepted aliases. Default: every discoverable kind

Maximum array length: 8

categorystring

statusstring

Default: active

Response

Resolve decision

application/json

outcomeenum<string>

Available options: match, uncertain, none

toolobject

Show child attributes

idstring

kindstring

typestring

namestring

descriptionstring

categorystring

statusstring

operationobject

Show child attributes

namestring

purposestring

gatedboolean

callobject

Show child attributes

required_paramsstring[]

example_cnlstring

confidencenumber | null

null on the keyword fallback (decision model unavailable)

alternativesobject[]

Show child attributes

idstring

kindstring

namestring

pnumber

modeenum<string>

Available options: shadow, act

invalid_json — body missing or no task

application/json

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

rate_limited — Retry-After header

application/json

errorobjectrequired

Show child attributes

codestringrequired

messagestringrequired

import os import requests response = requests.post( "https://api.plungeai.com/v1/discovery/resolve", headers={"Authorization": f"Bearer {os.environ['PLUNGE_API_KEY']}"}, json={ "task": "<string>", }, ) if not response.ok: raise SystemExit(f"{response.status_code} {response.headers.get('X-Error-Code')}") print(response.json())

const response = await fetch('https://api.plungeai.com/v1/discovery/resolve', { method: 'POST', headers: { Authorization: `Bearer ${process.env.PLUNGE_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ "task": "<string>" }), }) if (!response.ok) throw new Error(`${response.status} ${response.headers.get('X-Error-Code')}`) console.log(await response.json())

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.plungeai.com/v1/discovery/resolve")) .header("Authorization", "Bearer " + System.getenv("PLUNGE_API_KEY")) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString("{\"task\":\"<string>\"}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); if (response.statusCode() >= 400) { System.out.println(response.statusCode() + " " + response.headers().firstValue("X-Error-Code").orElse("")); return; } System.out.println(response.body()); } }

{ "outcome": "match", "tool": { "id": "<string>", "kind": "<string>", "type": "<string>", "name": "<string>", "description": "<string>", "category": "<string>", "status": "<string>" }, "operation": { "name": "<string>", "purpose": "<string>", "gated": true }, "call": { "required_params": [ "<string>" ], "example_cnl": "<string>" }, "confidence": 0, "alternatives": [ { "id": "<string>", "kind": "<string>", "name": "<string>", "p": 0 } ], "mode": "shadow" }

Resolve a task to one tool, its operation and an example call, with a…

Authorizations

Body

Response

Planned: TI-33

Planned: TI-34