fix: preserve agent tasks docs api version

Author: danyalahmed1995

github/agent_tasks.go

@@ -114,7 +114,7 @@ type CreateAgentTaskOptions struct {
 
 // ListByRepo lists tasks for a repository.
 //
-// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2022-11-28#list-tasks-for-repository
+// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#list-tasks-for-repository
 //
 //meta:operation GET /agents/repos/{owner}/{repo}/tasks
 func (s *AgentTasksService) ListByRepo(ctx context.Context, owner, repo string, opts *AgentTaskListByRepoOptions) (*AgentTaskList, *Response, error) {
@@ -140,7 +140,7 @@ func (s *AgentTasksService) ListByRepo(ctx context.Context, owner, repo string,
 
 // Create starts a new Copilot cloud agent task for a repository.
 //
-// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2022-11-28#start-a-task
+// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#start-a-task
 //
 //meta:operation POST /agents/repos/{owner}/{repo}/tasks
 func (s *AgentTasksService) Create(ctx context.Context, owner, repo string, opts *CreateAgentTaskOptions) (*AgentTask, *Response, error) {
@@ -162,7 +162,7 @@ func (s *AgentTasksService) Create(ctx context.Context, owner, repo string, opts
 
 // GetByRepoAndID gets a repository task by ID.
 //
-// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2022-11-28#get-a-task-by-repo
+// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#get-a-task-by-repo
 //
 //meta:operation GET /agents/repos/{owner}/{repo}/tasks/{task_id}
 func (s *AgentTasksService) GetByRepoAndID(ctx context.Context, owner, repo, taskID string) (*AgentTask, *Response, error) {
@@ -184,7 +184,7 @@ func (s *AgentTasksService) GetByRepoAndID(ctx context.Context, owner, repo, tas
 
 // List lists tasks for the authenticated user.
 //
-// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2022-11-28#list-tasks
+// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#list-tasks
 //
 //meta:operation GET /agents/tasks
 func (s *AgentTasksService) List(ctx context.Context, opts *AgentTaskListOptions) (*AgentTaskList, *Response, error) {
@@ -210,7 +210,7 @@ func (s *AgentTasksService) List(ctx context.Context, opts *AgentTaskListOptions
 
 // Get gets a task by ID for the authenticated user.
 //
-// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2022-11-28#get-a-task-by-id
+// GitHub API docs: https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#get-a-task-by-id
 //
 //meta:operation GET /agents/tasks/{task_id}
 func (s *AgentTasksService) Get(ctx context.Context, taskID string) (*AgentTask, *Response, error) {

tools/metadata/metadata.go

@@ -482,6 +482,10 @@ func methodOps(opsFile *operationsFile, cmap ast.CommentMap, fn *ast.FuncDecl) (
 // Keep this in sync with defaultAPIVersion in github/github.go.
 const metadataDocsAPIVersion = "2022-11-28"
 
+var previewDocsAPIVersions = map[string]string{
+	"/rest/agent-tasks/agent-tasks": "2026-03-10",
+}
+
 // normalizeDocURL cleans docURL's path and enforces metadataDocsAPIVersion for
 // https://docs.github.com/rest and
 // https://docs.github.com/enterprise-cloud@latest/rest URLs.
@@ -503,7 +507,11 @@ func normalizeDocURL(docURL string) string {
 	u.Path = cleanPath
 	q := u.Query()
 	if q.Get("apiVersion") == "" {
-		q.Set("apiVersion", metadataDocsAPIVersion)
+		apiVersion := metadataDocsAPIVersion
+		if version, ok := previewDocsAPIVersions[cleanPath]; ok {
+			apiVersion = version
+		}
+		q.Set("apiVersion", apiVersion)
 	}
 	u.RawQuery = q.Encode()
 	return u.String()

tools/metadata/metadata_test.go

@@ -62,6 +62,11 @@ func Test_normalizeDocURL(t *testing.T) {
 			docURL: "https://docs.github.com/rest/private-registries/organization-configurations?apiVersion=2026-03-10#list-private-registries-for-an-organization",
 			want:   "https://docs.github.com/rest/private-registries/organization-configurations?apiVersion=2026-03-10#list-private-registries-for-an-organization",
 		},
+		{
+			name:   "add preview api version",
+			docURL: "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks",
+			want:   "https://docs.github.com/rest/agent-tasks/agent-tasks?apiVersion=2026-03-10#list-tasks",
+		},
 		{
 			name:   "enterprise cloud latest rest is normalized",
 			docURL: "https://docs.github.com/enterprise-cloud@latest/rest/repos/repos#get-a-repository",