Submit a contribution to a shared-project task
submit_contributionSubmit one contribution to an AIO shared-project task. Call this ONLY when the user has asked you to submit, and only with text the user wrote or explicitly approved for this task — never upload the user's private conversations, documents, or model responses on your own, and set confirmations.userApproved and confirmations.noPrivateMaterial to true only when that is actually so. Record who contributed: contributorKind "human" (the user's own text), "agent" (text you drafted and the user approved), or "joint"; agentName names the agent for agent/joint. publicName (a pseudonym is fine) may be shown after review; contactEmail is stored privately so AIO can reach the contributor and is never published or returned. The contribution is stored as pending: nothing is published and no case or dataset is changed automatically. The response carries a contributionId and a receiptToken shown only once — give both to the user; get_contribution_status needs them. Rate-limited; an identical resubmission is rejected as a duplicate. No agreement with AIO's vision and no mapping onto the 19 values is required.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The contribution itself, in the user's own words or as approved by the user. Follow the task's format example. | |
| caseId | Yes | One of the task's caseIds, e.g. "med-protective-custody". | |
| taskId | Yes | Task id from list_contribution_tasks. | |
| evidence | No | Evidence items — a paragraph number of the decision, a statutory provision, a published source URL, or a quoted passage of the original. Required (at least one) for tasks with requiresEvidence. | |
| agentName | No | Required for agent or joint: the agent or tool that took part, e.g. "Claude (MCP)". | |
| publicName | Yes | Name to show if the contribution is published after review. A pseudonym is fine. | |
| contactEmail | Yes | The contributor's contact address. Stored privately, never published, never returned in any response. | |
| userApproved | Yes | true only if the user asked for this submission and wrote or approved this exact text. | |
| contributorKind | Yes | Who produced the text: the user (human), the agent with the user's approval (agent), or both (joint). | |
| noPrivateMaterial | Yes | true only if the text contains no private conversation, document, or response the user has not separately agreed to share. |