Skip to main content
GET
/
api
/
public
/
v2
/
tool-registry
/
{identifier}
Get Tool Registry
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/tool-registry/{identifier} \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "tool_registry": {
    "id": 123,
    "name": "<string>",
    "description": "<string>",
    "workspace_id": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "labels": [
      {}
    ],
    "version": {},
    "tool_definition": {}
  }
}
Retrieve a tool from the Tool Registry by ID or name. Optionally resolve a specific version using the label or version query parameter. If neither is specified, the latest version is returned. The identifier can be either:
  • A numeric tool ID (e.g., 123)
  • A tool name (e.g., get_weather)
The resolved version includes the tool_definition. If the version was saved with an auto-execution body, it also includes an execution: { type, language, code } object.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
identifier
string
required

Tool ID (numeric) or name

Query Parameters

​
label
string

Resolve version by label name (e.g. production)

​
version
string

Resolve by specific version number

Response

Successful Response

​
success
boolean
​
tool_registry
object