> For the complete documentation index, see [llms.txt](https://talque.gitbook.io/public/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://talque.gitbook.io/public/deep-links/map-links/talque-map-deep-link.md).

# Talque Map Deep Link

## Open a map tour via deep link (redirect)

> Generates a deep link that opens a specific map tour in an organization.\
> \
> \`GET\` redirects the browser to the frontend deep-link handler URL.\
> \
> \`POST\` returns the parsed hyperlink as JSON so the frontend can\
> programmatically inspect the destination without following a redirect.<br>

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/tour/{map_tour_id}/{action}":{"get":{"summary":"Open a map tour via deep link (redirect)","description":"Generates a deep link that opens a specific map tour in an organization.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"map_tour_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map tour ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"302":{"description":"Redirect to the frontend deep-link handler URL.","headers":{"Location":{"schema":{"type":"string"},"description":"Frontend URL containing the encoded hyperlink token."}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```

## Open a map tour via deep link (JSON)

> Same as GET but returns the hyperlink as JSON instead of redirecting.

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/tour/{map_tour_id}/{action}":{"post":{"summary":"Open a map tour via deep link (JSON)","description":"Same as GET but returns the hyperlink as JSON instead of redirecting.","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"map_tour_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map tour ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"200":{"description":"Parsed hyperlink token.","content":{"application/json":{"schema":{"type":"object","properties":{"hyperlink":{"type":"string","description":"JWT-encoded hyperlink token."},"success":{"type":"boolean"},"reason":{"type":"string"},"reasonEnum":{"type":"string"}},"required":["hyperlink","success","reason","reasonEnum"]}}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```

## Open a vendor booth on the map via deep link (redirect)

> Generates a deep link that opens a vendor booth on the map in an organization.\
> \
> The vendor is resolved by internal VendorIdentifier first; if not found,\
> an external ID lookup is performed as a fallback.\
> \
> \`GET\` redirects the browser to the frontend deep-link handler URL.\
> \
> \`POST\` returns the parsed hyperlink as JSON so the frontend can\
> programmatically inspect the destination without following a redirect.<br>

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/{action}":{"get":{"summary":"Open a vendor booth on the map via deep link (redirect)","description":"Generates a deep link that opens a vendor booth on the map in an organization.\n\nThe vendor is resolved by internal VendorIdentifier first; if not found,\nan external ID lookup is performed as a fallback.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string"},"description":"VendorIdentifier or external vendor ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"302":{"description":"Redirect to the frontend deep-link handler URL.","headers":{"Location":{"schema":{"type":"string"},"description":"Frontend URL containing the encoded hyperlink token."}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```

## Open a vendor booth on the map via deep link (JSON)

> Same as GET but returns the hyperlink as JSON instead of redirecting.

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/{action}":{"post":{"summary":"Open a vendor booth on the map via deep link (JSON)","description":"Same as GET but returns the hyperlink as JSON instead of redirecting.","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string"},"description":"VendorIdentifier or external vendor ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"200":{"description":"Parsed hyperlink token.","content":{"application/json":{"schema":{"type":"object","properties":{"hyperlink":{"type":"string","description":"JWT-encoded hyperlink token."},"success":{"type":"boolean"},"reason":{"type":"string"},"reasonEnum":{"type":"string"}},"required":["hyperlink","success","reason","reasonEnum"]}}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```

## Open a specific map feature for a vendor via deep link (redirect)

> Generates a deep link that opens a specific map feature for a vendor in an organization.\
> \
> \`GET\` redirects the browser to the frontend deep-link handler URL.\
> \
> \`POST\` returns the parsed hyperlink as JSON so the frontend can\
> programmatically inspect the destination without following a redirect.<br>

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/booth/{map_feature_id}/{action}":{"get":{"summary":"Open a specific map feature for a vendor via deep link (redirect)","description":"Generates a deep link that opens a specific map feature for a vendor in an organization.\n\n`GET` redirects the browser to the frontend deep-link handler URL.\n\n`POST` returns the parsed hyperlink as JSON so the frontend can\nprogrammatically inspect the destination without following a redirect.\n","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string"},"description":"VendorIdentifier or external vendor ID."},{"name":"map_feature_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map feature ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"302":{"description":"Redirect to the frontend deep-link handler URL.","headers":{"Location":{"schema":{"type":"string"},"description":"Frontend URL containing the encoded hyperlink token."}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```

## Open a specific map feature for a vendor via deep link (JSON)

> Same as GET but returns the hyperlink as JSON instead of redirecting.

```json
{"openapi":"3.0.3","info":{"title":"Talque Map Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/map/{map_layer_id}/partner/{vendor_id}/booth/{map_feature_id}/{action}":{"post":{"summary":"Open a specific map feature for a vendor via deep link (JSON)","description":"Same as GET but returns the hyperlink as JSON instead of redirecting.","parameters":[{"name":"org_id","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID."},{"name":"map_layer_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map layer ID."},{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string"},"description":"VendorIdentifier or external vendor ID."},{"name":"map_feature_id","in":"path","required":true,"schema":{"type":"string"},"description":"Map feature ID."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["view"]},"description":"Action to perform."}],"responses":{"200":{"description":"Parsed hyperlink token.","content":{"application/json":{"schema":{"type":"object","properties":{"hyperlink":{"type":"string","description":"JWT-encoded hyperlink token."},"success":{"type":"boolean"},"reason":{"type":"string"},"reasonEnum":{"type":"string"}},"required":["hyperlink","success","reason","reasonEnum"]}}}},"400":{"description":"Bad request — an ID could not be parsed."},"404":{"description":"Organization not found."}}}}}}
```