> ## Documentation Index > Fetch the complete documentation index at: https://docs.atollhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Read actor work suggestions > Complete bounded global ranking in the caller/target authorization intersection. Machines self only; human targets require management or assignment authority. Every nonterminal execution occupies the target across the organization. Hidden occupation yields only a generic caveat. Current work is inspection, not retry supersession or dispatch authority. Inactive targets reveal only authorized lifecycle/identity with no work or former scope. Signed 15-minute actor pages reject evidence drift with 409. No assignment, execution, reservation, or heartbeat mutation. CLI work recommendations and full/public MCP atoll_get_work_recommendations use this contract. ## OpenAPI ````yaml /openapi.json get /api/orgs/{id}/work-recommendations openapi: 3.1.0 info: title: Atoll API version: 1.0.0 description: >- REST API for Atoll project management, agent collaboration, strategy tracking, and integrations. servers: - url: https://atollhq.com description: Production security: - bearerAuth: [] tags: - name: Authentication - name: Organizations - name: Projects - name: Project access - name: Issues - name: Issue details - name: Milestones - name: Artifacts - name: Strategy - name: Members and agents - name: Planning - name: Setup - name: Integrations and billing - name: Notifications and public - name: Private inbox - name: Agent executions - name: Human attention - name: Products paths: /api/orgs/{id}/work-recommendations: get: tags: - Planning summary: Read actor work suggestions description: >- Complete bounded global ranking in the caller/target authorization intersection. Machines self only; human targets require management or assignment authority. Every nonterminal execution occupies the target across the organization. Hidden occupation yields only a generic caveat. Current work is inspection, not retry supersession or dispatch authority. Inactive targets reveal only authorized lifecycle/identity with no work or former scope. Signed 15-minute actor pages reject evidence drift with 409. No assignment, execution, reservation, or heartbeat mutation. CLI work recommendations and full/public MCP atoll_get_work_recommendations use this contract. operationId: actorWorkRecommendations parameters: - name: id in: path required: true schema: type: string format: uuid - name: actor_id in: query required: false schema: type: string format: uuid - name: project_id in: query required: false schema: type: string format: uuid - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 5 default: 5 - name: cursor in: query required: false schema: type: string maxLength: 2048 responses: '200': description: Read-only snapshot content: application/json: schema: $ref: '#/components/schemas/ActorWorkRecommendations' '400': description: Invalid input, cursor scope/signature, or expired actor cursor content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string '401': description: Authentication required content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string '404': description: Missing or forbidden project/target content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string '409': description: Actor cursor or evidence changed; restart without cursor content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string '422': description: Complete bounded evidence exceeded; no partial ranking content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string '500': description: Evidence read or validation failed content: application/json: schema: type: object additionalProperties: false required: - error - code properties: error: type: string code: type: string components: schemas: ActorWorkRecommendations: type: object properties: actor: type: object properties: id: type: string format: uuid type: type: string enum: - human - agent - integration lifecycle: anyOf: - type: object properties: state: type: string enum: - enabled - disabled - revoked version: type: integer exclusiveMinimum: 0 required: - state - version additionalProperties: false - type: 'null' required: - id - type - lifecycle additionalProperties: false scope: type: object properties: project_id: anyOf: - 56c549e6-2712-4055-937d-515f72309db7 - type: 'null' required: - project_id additionalProperties: false recommendations: type: array items: type: object properties: issue: type: object properties: id: 6476b23b-402a-4894-a121-e65d6ffdaf3a number: anyOf: - type: integer - type: 'null' title: type: string status: type: string minLength: 1 priority: anyOf: - type: integer minimum: 0 maximum: 3 - type: 'null' due_date: anyOf: - type: string pattern: ^\d{4}-\d{2}-\d{2}$ - type: 'null' created_at: type: string pattern: >- ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,6})?(?:Z|\+00:00)$ updated_at: 73be6f68-4ec7-4118-a200-a2251fcb7df4 required: - id - number - title - status - priority - due_date - created_at - updated_at additionalProperties: false project: type: object properties: id: 8c7d2cb0-0092-4ea7-ae70-78e77dfa81b0 name: 60b079fd-e20a-40cf-a9b3-b570e77961de slug: 8fabb1c3-dc97-48ff-9dad-078a4cdb5f69 required: - id - name - slug additionalProperties: false action_kind: type: string enum: - start - continue - review_assignment reasons: type: array items: anyOf: - type: object properties: source_id: e3c8da0d-aef2-4ed5-9e96-e14230e33f06 source_title: 55e0904f-ebd4-420d-b7c1-21808ac86b89 source_as_of: 50e69391-4660-4373-891a-172f99014a53 code: type: string enum: - urgent_blocked_downstream - issue_overdue - issue_due - issue_priority source_type: type: string const: issue summary: type: string maxLength: 300 required: - source_id - code - source_type - summary additionalProperties: false - type: object properties: source_id: 8a1b5a33-515c-4939-9d14-51caed1ee90e source_title: fb47d5d4-c823-4a41-9f6d-8016deba1e8b source_as_of: a9f76c82-3350-434d-a474-dbf1eee2fe19 code: type: string const: overdue_milestone source_type: type: string const: milestone summary: type: string maxLength: 300 required: - source_id - code - source_type - summary additionalProperties: false - type: object properties: source_id: ceb822db-c19c-46af-9db1-593d5dfe92ad source_title: c84f88b3-014b-40de-b173-54020b653c52 source_as_of: 5b141698-6dc0-4b4e-80ea-50ef32886a50 code: type: string const: current_kpi_relevance source_type: type: string const: kpi summary: type: string maxLength: 300 required: - source_id - code - source_type - summary additionalProperties: false - type: object properties: source_id: 3169c276-5b95-4277-9bce-dd8adc7abd51 source_title: ee0bacf1-68ad-4242-814a-127b254032da source_as_of: c55ed9b0-fadf-4ca7-a436-78ea5ee94028 code: type: string const: explicit_strategy_link source_type: type: string const: initiative summary: type: string maxLength: 300 required: - source_id - code - source_type - summary additionalProperties: false maxItems: 3 limitations: type: array items: anyOf: - type: object properties: code: type: string enum: - kpi_stale - kpi_current_unknown - strategy_link_absent - kpi_evidence_absent - linked_context_not_visible - assignment_requires_review - linked_context_unavailable - strategy_inactive source_id: ae90c8ee-89be-45bd-be0b-c3129758d292 source_title: b236f284-8f83-4fb6-ba36-8b54f795109f source_as_of: b3d70434-c4a5-41d2-b9c4-d793e7d3b271 source_type: type: string enum: - issue - milestone - initiative - kpi required: - code - source_id - source_type additionalProperties: false - type: object properties: code: 1217e5e2-7716-4240-92de-2f2f5164e557 required: - code additionalProperties: false maxItems: 5 limitations_truncated: type: boolean required: - issue - project - action_kind - reasons - limitations - limitations_truncated additionalProperties: false maxItems: 5 current_work: type: array items: type: object properties: issue: 3787cb81-ea0a-4ac1-9120-231c5f5e31c7 project: anyOf: - a331e6ec-e4e1-4e66-9acb-2bb0bf98a178 - type: 'null' action: type: string enum: - inspect_current_work - inspect_waiting_work - inspect_attention - inspect_failed_work - review_assignment assignment_conflict: type: boolean execution: anyOf: - type: object properties: id: c43588a0-fe04-49ed-961d-447520a63bca state: type: string enum: - assigned - running - waiting - needs_human - succeeded - failed - cancelled state_version: type: integer exclusiveMinimum: 0 required: - id - state - state_version additionalProperties: false - type: 'null' required: - issue - project - action - assignment_conflict - execution additionalProperties: false maxItems: 20 current_work_truncated: type: boolean can_assign: type: boolean availability: type: string enum: - available_for_recommendation - occupied - availability_not_established - inactive caveats: type: array items: type: string enum: - snapshot_not_reservation - availability_not_established maxItems: 2 evaluation: type: object properties: evaluated_at: 27b0ae2f-f560-4751-9cd8-4f983c217e9b required: - evaluated_at additionalProperties: false page: type: object properties: limit: type: integer minimum: 1 maximum: 5 has_more: type: boolean next_cursor: anyOf: - type: string maxLength: 2048 - type: 'null' required: - limit - has_more - next_cursor additionalProperties: false required: - actor - scope - recommendations - current_work - current_work_truncated - can_assign - availability - caveats - evaluation - page additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_atoll_ ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.