> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Attach Resource

> Attach a call, SMS conversation, or file to an issue.

## Overview

Attaches a resource as evidence on an issue. Resources are what Norm reads during an investigation. Attaching the same resource twice is a no-op.

If the issue does not belong to an agent yet, attaching a call assigns it to the agent that handled that call. An issue that already belongs to an agent keeps it.

For calls specifically, [Attach Call](https://docs.bland.ai/api-v1/put/triage-issues-id-calls-call-id.md) is a shorthand that takes the `call_id` directly.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Path Parameters

**id** `string` *required*

Internal UUID of the issue.

***

## Body Parameters

**resource\_type** `string` *required*

Type of resource to attach. One of `call`, `sms_conversation`, or `file`.

**resource\_id** `string` *required*

ID of the resource. For calls, this is the `call_id` returned by [Send Call](https://docs.bland.ai/api-v1/post/calls.md).

***

## Response

Returns `201 Created` with the new resource link. If the resource was already attached, returns the existing link with `200 OK`.

**data** `object`

**Resource link fields**

**id** `string`

Internal UUID of the resource link. Use this to detach with [Remove Resource](https://docs.bland.ai/api-v1/delete/triage-issues-id-resources-resource-link-id.md).

**issue\_id** `string`

**org\_id** `string`

**resource\_type** `string`

`call`, `sms_conversation`, or `file`.

**resource\_id** `string`

The original resource ID you attached.

**title** `string`

Display title resolved from the resource itself. For calls this is typically a one-line summary of the conversation.

**status** `string`

`available` if the underlying resource still exists and is readable, or `unavailable` if it has been deleted or is not accessible.

**metadata** `object | null`

Extra metadata snapshotted from the resource at attach time, for example the call's `created_at`.

**attached\_by\_id** `string | null`

User ID of the caller that attached the resource.

**created\_at** `string`

ISO 8601 timestamp.

**errors** `null | array`

`null` on success. Returns 404 if the issue or the underlying resource cannot be found in your org.

```json Response theme={null}
{
  "data": {
    "id": "1d8cec02-6b7c-43f9-9f1f-86d4f31b6d8a",
    "issue_id": "9bbe5547-d5b1-4b83-9f80-87c4af7c6b34",
    "org_id": "f5b40b9e-bc05-4b8a-9af1-d8f6a8a3a201",
    "resource_type": "call",
    "resource_id": "3e3af63d-0cc0-4525-b742-72a5367fd072",
    "title": "Caller asked to be transferred to billing after the agent failed to verify their account.",
    "status": "available",
    "metadata": {
      "created_at": "2026-04-30T14:11:08.000Z"
    },
    "attached_by_id": "75c5c7da-a5d6-4e26-a51e-1ae8ef2bfa4a",
    "created_at": "2026-05-07T05:25:56.361Z"
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.