Skip to Content
CallMitraDocs
API referenceAgents

Get a tool

One tool by id. Credentials are never returned (`authSecretSet` says whether one is stored).

GET
/api/v1/tools/{tool_id}

One tool by id. Credentials are never returned (authSecretSet says whether one is stored).

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

tool_id*Tool Id

Response Body

OK

application/json
  1. response

One tool.

success?Success

Always true on success.

Defaulttrue
tool*

An action an agent can take during a call.

[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/tools/string'
Example Response
{  "success": true,  "tool": {    "authSecretSet": true,    "description": "Book a site visit once the caller picks a date.",    "id": "5b6c7d8e-9f01-4a2b-8c3d-4e5f60718293",    "isActive": true,    "kind": "api_request",    "method": "POST",    "name": "book_site_visit",    "url": "https://example.com/api/visits"  }}

Get an agent GET

The agent with its published `config`, working `draftConfig`, status and phone numbers.

Import an agent from another platform POST

Creates a **draft** agent from JSON exported from another platform. Review it, then publish with publishAgent. Fields that have no equivalent, and values that had to be approximated, are listed in `warnings` instead of failing the import. | Our field | Vapi | Retell | Bland | | --- | --- | --- | --- | | name | `name` | `agent_name` | `name` | | system prompt | system entries of `model.messages` | `llm.general_prompt` | `task` (or `prompt`) | | greeting | `firstMessage` | `llm.begin_message` | `first_sentence` | | language model | `model.model` | `llm.model` | `model` (Bland tiers map to the default) | | temperature | `model.temperature` | `llm.model_temperature` | `temperature` | | voice | `voice.provider` + `voice.voiceId` | `voice_id` | `voice` | | transcriber | `transcriber.provider` | - | - | | language | `transcriber.language` | `language` | `language` | | speaking speed | `voice.speed` | `voice_speed` | - | | call time limit | `maxDurationSeconds` | `max_call_duration_ms` | `max_duration` (minutes) | | background sound | `backgroundSound` | `ambient_sound` | `background_track` | | recording | `recordingEnabled` | - | `record` | A voice or language that is not available here is replaced: first by a voice with the same id or name, then by the language's default voice, with a warning. Tools, knowledge bases, webhooks and multi-state flows are not imported. `callmitra` copies another workspace's agent config (signing secrets are not copied).