Provider Tools

Get provider tool

Retrieves a specific provider tool by ID.

get/provider-tools/{provider_tool_id}

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Path parameters

provider_tool_idstring required

Unique identifier of the provider tool.

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

object'provider.tool' required

String representing the object's type

idstring required

Unique tool identifier

keystring required

Tool key

namestring required

Display name of the tool

descriptionstring nullable required

Tool description

capabilitiesobject required

Tool capabilities

constraintsstring[] required

Tool constraints

instructionsstring[] required

Tool usage instructions

tool_category_keysstring[] required

Keys of the tool categories this tool belongs to

specification_idstring required

Specification ID

provider_idstring required

Provider ID

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "id": "pto_5jKlMnPqRsTuVwXy",
  "key": "create_issue",
  "name": "Create Issue",
  "description": "Creates a new issue in a GitHub repository",
  "specification_id": "psp_9gHjKlMnPqRsTuVw",
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.