Skip to content

docs(provisioning): document path parameter for deep links endpoint#17321

Open
inkeep[bot] wants to merge 2 commits into
masterfrom
docs-writer-ai-update-2026-06-05T14-00-48-000Z-ef5b72
Open

docs(provisioning): document path parameter for deep links endpoint#17321
inkeep[bot] wants to merge 2 commits into
masterfrom
docs-writer-ai-update-2026-06-05T14-00-48-000Z-ef5b72

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented Jun 5, 2026

Changes

Documents the new path parameter for the Provisioning API deep links endpoint (POST /api/agentic/provisioning/deep_links).

What's new

Partners can now deep link users to any in-app path (e.g., a specific session recording, insight, or settings screen) instead of only the project home.

Documentation updates

  • Deep linking intro – Mentions the optional path for targeting specific in-app pages
  • Sequence diagram – Shows "redirect to path or /project/N"
  • Curl example – Includes path in the request body with a realistic example
  • Request fields table – Documents both purpose (now a free-form analytics label) and the new path field
  • Path validation note – Explains security constraints (relative, same-origin paths only)
  • Error codes table – Adds invalid_path (400) error code
  • JavaScript helper – Updated getDeepLinkUrl to accept an optional path parameter

Related to: PostHog/posthog#60740


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

inkeep Bot added 2 commits June 5, 2026 14:03
Updates provisioning API docs to reflect PR #60740 which adds an
optional `path` parameter to the deep links endpoint, allowing
partners to redirect users to any specific in-app page instead
of just the project home.
@inkeep inkeep Bot requested a review from MattBro June 5, 2026 14:09
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

Vale prose linter → found 0 errors, 15 warnings, 13 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/integrate/provisioning.mdx — 0 errors, 15 warnings, 13 suggestions
Line Severity Message Rule
8:140 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
14:15 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
42:71 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
42:76 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
42:157 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
99:144 warning 'org's' is a possible misspelling. PostHogBase.Spelling
125:5 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
131:50 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
131:145 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
174:59 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
190:1 suggestion Address the reader directly. Use 'you' instead of 'The user'. PostHogDocs.DirectAddress
204:42 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
271:44 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
333:228 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
333:233 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
333:323 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
353:143 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
367:199 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
429:34 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
430:34 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
441:9 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
443:35 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
446:32 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
453:14 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
465:38 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
491:18 warning Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. PostHogBase.ProductNames
505:20 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
617:74 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jun 05, 2026 02:23PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 5, 2026

Hey @MattBro! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants