# Read an agent's tools for a share link

Source: https://docs.vlayers.ai/reference/share-links/get-agent-share-tools

`GET /v1/agents/{id}/share-links/tools` · scope `share_links:read`

Lists the tools the agent has, for its published version (`live`) and its draft as it is now (`draft`), as a share link would carry them: a tool that only reads is on for every link (`read`), a tool that may change something is off until you name it in `toolsOn` when you make the link, and a tool that would send a message, place a call or transfer to a destination taken from the conversation is never available (`alwaysOff`). Each carries `reason`, the one sentence that says why. Read the draft's list before you make a link to the draft: it is the version the link will run.

Requires an API key with the `share_links:read` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/share-links/tools" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { live } = await voicelayer.shareLinks.getAgentShareTools('<agent-id>');
console.log(live);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.shareLinks.get_agent_share_tools("<agent-id>")
print(result.live)
```

## Response `200`

```json
{
  "live": [
    {
      "name": "lookup_order",
      "source": "http",
      "read": true,
      "alwaysOff": false,
      "reason": "It only reads, so it is on for every link."
    },
    {
      "name": "refund_order",
      "source": "http",
      "read": false,
      "alwaysOff": false,
      "reason": "A stranger could make your agent change something real or spend through it before you chose that."
    },
    {
      "name": "vl_send_text",
      "source": "action",
      "read": false,
      "alwaysOff": true,
      "reason": "A stranger could make your agent text, call or transfer to a number they chose."
    }
  ],
  "draft": null,
  "draftProblem": "tool_secret_header"
}
```
