> 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/lecture-links/talque-lecture-deep-link.md).

# Talque Lecture Deep Link

## Open a lecture via deep link (redirect)

> Generates a deep link that opens a specific lecture 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 Lecture Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/lecture/{event_id}/{action}":{"get":{"summary":"Open a lecture via deep link (redirect)","description":"Generates a deep link that opens a specific lecture 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":"event_id","in":"path","required":true,"schema":{"type":"string"},"description":"EventIdentifier string."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["info","enroll","unenroll","rate-speakers","favorite"]},"description":"Action to perform on the lecture."}],"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 lecture via deep link (JSON)

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

```json
{"openapi":"3.0.3","info":{"title":"Talque Lecture Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/lecture/{event_id}/{action}":{"post":{"summary":"Open a lecture 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":"event_id","in":"path","required":true,"schema":{"type":"string"},"description":"EventIdentifier string."},{"name":"action","in":"path","required":true,"schema":{"type":"string","enum":["info","enroll","unenroll","rate-speakers","favorite"]},"description":"Action to perform on the lecture."}],"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 the lecture list / schedule via deep link (redirect)

> Generates a deep link that opens the lecture list / schedule in an organization.\
> \
> Optional filter query parameters may be passed and will be forwarded to\
> the frontend deep-link handler.\
> \
> \`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 Lecture Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/schedule":{"get":{"summary":"Open the lecture list / schedule via deep link (redirect)","description":"Generates a deep link that opens the lecture list / schedule in an organization.\n\nOptional filter query parameters may be passed and will be forwarded to\nthe frontend deep-link handler.\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."}],"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 the lecture list / schedule via deep link (JSON)

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

```json
{"openapi":"3.0.3","info":{"title":"Talque Lecture Deep Link","version":"1.0.0"},"paths":{"/go/org/{org_id}/schedule":{"post":{"summary":"Open the lecture list / schedule 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."}],"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."}}}}}}
```