v9

OpenAPI 3.1.02026-08-0352108381.8 KB
App URLs
App URLs

Generate App Url

Build a deep link into the TheirStack app for a given resource and return it as {"url": ...}. Pick the resource with the type field: company_list (view a list), job_search / company_search (open a search from filters — same filter shape as search_jobs_v1 / search_companies_v1), saved_search (open a saved search), or webhook (view a webhook). Search links (job_search / company_search) are workspace-independent — the encoded query opens against whoever's session loads it, so the link is portable when shared. The other types point at a workspace-specific resource and include the workspace, which is taken from the authenticated caller, so it is never passed in.

post/v0/app-urls

Request body

OR
OR
OR
OR

Example request

{
  "list_id": 12345
}

Response

Successful Response

urlstring required

Full workspace-scoped URL into the TheirStack app

Example response

{
  "url": "https://app.theirstack.com/workspace/123/webhooks/42"
}