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

# link_ticket_issue

> Record the Linear or Notion issue a Montra ticket was exported to.

Records where a ticket now lives downstream — the Linear issue or Notion page you just created from it — so the Montra ticket shows a link back to it.

A ticket holds one link per provider. Calling this again for the same ticket and provider re-points the existing link rather than adding a second one.

## Input

<ParamField body="ticketId" type="string" required>
  Id of the Montra ticket (UUID).
</ParamField>

<ParamField body="provider" type="string" required>
  External system the ticket was exported to: `linear` or `notion`.
</ParamField>

<ParamField body="identifier" type="string" required>
  Provider-facing id of the issue or page, such as a Linear identifier like `MON-123`. Trimmed; 1–64 characters.
</ParamField>

<ParamField body="url" type="string" required>
  Deep link to the external issue or page. Must be an `https` URL.
</ParamField>

## Output

<ResponseField name="link" type="object" required>
  <Expandable title="properties">
    <ResponseField name="id" type="string" required>Id of the recorded link.</ResponseField>
    <ResponseField name="ticketId" type="string" required>Id of the Montra ticket the link belongs to.</ResponseField>
    <ResponseField name="documentId" type="string" required>Id of the document that ticket belongs to.</ResponseField>
    <ResponseField name="provider" type="string" required>`linear` or `notion`.</ResponseField>
    <ResponseField name="identifier" type="string" required>Provider-facing id of the issue or page.</ResponseField>
    <ResponseField name="url" type="string" required>Deep link to the external issue or page.</ResponseField>
  </Expandable>
</ResponseField>

## Notes

* When you create the external issue, link it back to Montra using that ticket's own durable `humanShareUrl` from the [share link payload](/tools/get-document-by-share-url) — not the `shareUrl` the payload was fetched with, which can be a legacy expiring link.
* Tickets outside the workspace this connection is bound to read as not found. See [workspace binding](/authentication#workspace-binding).
* Related: [`set_ticket_status`](/tools/set-ticket-status), [`get_ticket`](/tools/get-ticket), and the [agent workflow guide](/guides/agent-workflow).