SpecifyDocs

projects_execute

tools/call

Execute a Projects operation with its typed payload. Account and credential scope come from the current key. list, get, collectionContext, tasksPage, taskGet and comments read in one call. Every write needs expectedVersion where it has one, and receipt: { operation, key, issuedAt, requestHash }, where operation names the write (tasks.create, tasks.update, tasks.move, comments.create), key is unique, issuedAt is now in milliseconds and requestHash is the SHA-256 hex of the payload without receipt, serialized as compact JSON with object keys sorted by localeCompare and undefined values left out. taskMove takes each column's generation from collectionContext.orders. tasksPage filters is a JSON string such as { statusId, assignee: { kind: 'unassigned' } }.

Scopes

read:projects

Reads need read:projects. Writes also need write:projects; creating and managing projects, statuses and settings also need manage:projects.

Inputs

operation"admitRead" | "renewRead" | "releaseRead" | "list" | "get" | "collectionContext" | "tasksPage" | "taskGet" | "sprintsList" | "create" | "update" | "setLegacyDefault" | "taskCreate" | "taskUpdate" | "taskMove" | "sprintCreate" | "sprintUpdate" | "statusCreate" | "statusUpdate" | "statusesReorder" | "tagCreate" | "tagUpdate" | "tagMerge" | "commentCreate" | "sprintStart" | "sprintRetry" | "sprintCancel" | "sprintComplete" | "metrics" | "overview" | "dashboard" | "burndown" | "sprintRolloverTask" | "rebalance" | "comments"Required
payloadobjectRequired
Operation payload from the Projects API contract; omit account/service/authorization selectors.

Returns

The selected Projects operation's result. A call returns content[0].text with the JSON result and structuredContent.result with the same value.

Listed when

The key has read:projects.