Get Block Candidates
get_block_candidatesList permission-safe project block candidates without exposing raw source or conversation bodies. Requires authenticated API authority and a selected project.
Instructions
Use when: List permission-safe Project block candidates without raw source or conversation bodies. Do not use when: a narrower tool better matches the intent, the project scope is unresolved, or the user has declined the action. Requires: authenticated API authority and an API-authorized selected Project. Effect: read. Human approval: not required for this read or staging action. Then: follow typed result state; review pending proposals/drafts before any canonical apply. On failure: login_required → login; project_not_selected → list_projects/select_project; permission_denied → stop; stale_version or conflict → read current state; projection_pending → report canonical success separately and wait.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| type | No | ||
| limit | No | ||
| cursor | No | ||
| status | No | ||
| projectId | No | Optional project id. Defaults to the project chosen with select_project. If omitted and no project is selected, the call is rejected with instructions to select one. | |
| currentPageId | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| status | Yes | ||
| warnings | Yes | ||
| authority | Yes | ||
| projectId | Yes | ||
| reviewUrl | Yes | ||
| idempotency | Yes | ||
| nextActions | Yes | ||
| reviewRequired | Yes | ||
| canonicalVersion | Yes | ||
| projectionStatus | Yes |