getDuplicateCollectionTaskStatus
Read-onlyIdempotent
Check the progress or completion status of a collection duplication task by providing its task ID.
Instructions
Gets the status of a collection duplication task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| taskId | Yes | The task's unique ID. |
Implementation Reference
- The handler function for getDuplicateCollectionTaskStatus. It calls GET /collection-duplicate-tasks/{taskId} to check the status of a collection duplication task.
export async function handler( args: z.infer<typeof parameters>, extra: { client: PostmanAPIClient; headers?: IsomorphicHeaders; serverContext?: ServerContext } ): Promise<CallToolResult> { try { const endpoint = `/collection-duplicate-tasks/${args.taskId}`; const query = new URLSearchParams(); const url = query.toString() ? `${endpoint}?${query.toString()}` : endpoint; const options: any = { headers: extra.headers, }; const result = await extra.client.get(url, options); return { content: [ { type: 'text', text: `${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}`, }, ], }; } catch (e: unknown) { if (e instanceof McpError) { throw e; } throw asMcpError(e); } } - Input schema: requires a taskId string parameter.
export const parameters = z.object({ taskId: z.string().describe("The task's unique ID.") }); - src/tools/getDuplicateCollectionTaskStatus.ts:6-14 (registration)Tool registration metadata: method name, description, schema, and annotations (read-only, idempotent).
export const method = 'getDuplicateCollectionTaskStatus'; export const description = 'Gets the status of a collection duplication task.'; export const parameters = z.object({ taskId: z.string().describe("The task's unique ID.") }); export const annotations = { title: 'Gets the status of a collection duplication task.', readOnlyHint: true, destructiveHint: false, idempotentHint: true, }; - src/enabledResources.ts:152-158 (registration)Listed in the 'full' enabled resources array, registering it as an available tool.
// Duplicate Collection 'duplicateCollection', 'getDuplicateCollectionTaskStatus', 'deleteApiCollectionComment', 'deleteSpecFile', 'getEnabledTools', 'searchPostmanElements', - src/enabledResources.ts:213-218 (registration)Listed in the 'minimal' enabled resources array, registering it as an available tool in minimal mode.
'duplicateCollection', 'getDuplicateCollectionTaskStatus', 'runCollection', 'getEnabledTools', 'updateCollectionRequest', ] as const;