Skip to content

feat: Agent Tasks#3176

Open
tmilewski wants to merge 5 commits intomainfrom
tom/user-4863-add-to-clerk-docs
Open

feat: Agent Tasks#3176
tmilewski wants to merge 5 commits intomainfrom
tom/user-4863-add-to-clerk-docs

Conversation

@tmilewski
Copy link
Copy Markdown
Member

@tmilewski tmilewski commented Mar 4, 2026

@tmilewski tmilewski self-assigned this Mar 4, 2026
@tmilewski tmilewski requested a review from a team as a code owner March 4, 2026 19:02
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 4, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Mar 6, 2026 4:27pm

Request Review

Comment thread docs/reference/backend/agent-tasks/revoke.mdx Outdated
Comment thread docs/reference/backend/agent-tasks/create.mdx Outdated
Comment thread docs/guides/development/testing/agent-tasks.mdx
## Parameters

<Properties>
- `agentTaskId`
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is documented correctly, but calling out that create() uses taskID and revoke() uses agentTaskId. It'd probably be better if they were consistently named the same.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@manovotny Good call-out. I've introduced backend changes (not live yet), to add agent_task_id and deprecate task_id.

Comment thread docs/guides/development/testing/overview.mdx Outdated
Comment thread docs/reference/backend/agent-tasks/create.mdx
### Agent tasks

The **Agent Task** resource allows you to create agent tasks that generate URLs for creating sessions on behalf of users. This is useful for automated testing or agent-driven flows where full authentication isn't practical. The `create()` operation returns an `AgentTask` object containing a `url` that, when visited, creates a session for the specified user.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree this makes the most sense in the Testing section of the docs, but I wonder if it's worth adding a similar section like this to the AI Overview page too.

Thoughts @brkalow?

tmilewski and others added 2 commits March 6, 2026 11:25
Co-authored-by: Michael Novotny <manovotny@gmail.com>
Co-authored-by: Michael Novotny <manovotny@gmail.com>
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.

2 participants