curl --request GET \
--url https://api.pomerado.ai/v1/tools/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/tools/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/tools/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "op_0f8e2d1c-4b3a-49e8-a7f6-e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Get a tool
One tool by its ID: its input and output schemas, effect, what its sign-in takes and its integration. A disabled tool, or another account’s private one, is not found.
curl --request GET \
--url https://api.pomerado.ai/v1/tools/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/tools/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/tools/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "op_0f8e2d1c-4b3a-49e8-a7f6-e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
a tool ID: the ID tools.list gives, such as op_ and a UUID
"op_0f8e2d1c-4b3a-49e8-a7f6-e5d4c3b2a190"
Response
The tool
a tool ID: the ID tools.list gives, such as op_ and a UUID
"op_0f8e2d1c-4b3a-49e8-a7f6-e5d4c3b2a190"
an integration ID: int_ and 32 lowercase hex digits
"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Show child attributes
Show child attributes
read changes nothing on the site; write changes something there
read, write Show child attributes
Show child attributes
Show child attributes
Show child attributes
What its sign-in takes; null when it needs none
Show child attributes
Show child attributes
Its tool name on its integration's MCP, such as get_claim_status