> ## Documentation Index
> Fetch the complete documentation index at: https://docs.earthcare.network/llms.txt
> Use this file to discover all available pages before exploring further.

# List Home Actions

> Thin alias of GET /automation/recommendations/. Same payload (`recommendations` array), same auth, same org scoping. `organization_id` is required. `business_slug` is required when the org has more than one business. Unauthenticated callers receive 401 (route is mounted).

First Home land idempotently seeds 1–3 Jaguar Actions with `opportunity=null` and `effect=suggest_accept` (types in connector, growth_plan, ambassador, purpose). Existing /automation/recommendations/ is unchanged.




## OpenAPI

````yaml /api/openapi.yaml get /home/actions/
openapi: 3.0.3
info:
  title: Earth Care Network API
  version: v1
  description: >
    REST API for the Earth Care Network platform — directory, CRM, context,
    metering/credits, and the prospecting engine.


    This is a **curated** reference covering the headline endpoints with
    accurate paths, methods, auth, and representative request/response bodies.
    ECN's API is largely function-based (DRF `@api_view`/`APIView` without
    serializers), so the raw drf-spectacular dump is sparse today; as the v2
    refactor migrates views to serializer-backed generics, this file is
    superseded by the generated schema (`manage.py spectacular --settings
    ecn.settings_docs`). See https://docs.earthcare.network for guides and the
    MCP surface.
servers:
  - url: https://earthcare.network/api/v1
    description: Production
  - url: https://test.earthcare.network/api/v1
    description: Test
  - url: http://localhost:8000/api/v1
    description: Local
security:
  - TokenAuth: []
tags:
  - name: Auth
    description: Authentication and the current user.
  - name: Directory
    description: The public directory of regenerative businesses.
  - name: Context
    description: AI-ready Context Packs.
  - name: CRM
    description: Contacts, deals, and tasks.
  - name: AI
    description: Metered AI execution through the gateway.
  - name: Credits
    description: Wallet, rate cards, and the usage ledger.
  - name: Prospecting
    description: Go-to-market profiles and lead discovery with buying signals.
  - name: MCP
    description: MCP API key management.
  - name: Automation
    description: Workflow automation.
  - name: Home
    description: V5 Home Growth — purpose, OKRs, honest money, and Actions.
paths:
  /home/actions/:
    get:
      tags:
        - Home
      summary: List Home Actions
      description: >
        Thin alias of GET /automation/recommendations/. Same payload
        (`recommendations` array), same auth, same org scoping.
        `organization_id` is required. `business_slug` is required when the org
        has more than one business. Unauthenticated callers receive 401 (route
        is mounted).


        First Home land idempotently seeds 1–3 Jaguar Actions with
        `opportunity=null` and `effect=suggest_accept` (types in connector,
        growth_plan, ambassador, purpose). Existing /automation/recommendations/
        is unchanged.
      parameters:
        - $ref: '#/components/parameters/OrgId'
        - name: business_slug
          in: query
          schema:
            type: string
          description: Required when the organization has more than one business.
      responses:
        '200':
          description: Same shape as GET /automation/recommendations/
          content:
            application/json:
              schema:
                type: object
                properties:
                  recommendations:
                    type: array
                    items:
                      $ref: '#/components/schemas/HomeAction'
        '400':
          description: business_required when the org has multiple businesses and no slug
        '401':
          description: Not authenticated
        '403':
          description: Not a member of this organization
components:
  parameters:
    OrgId:
      name: organization_id
      in: query
      required: true
      schema:
        type: string
        format: uuid
      description: >-
        Your organization UUID. Workspace endpoints are org-scoped — supply this
        as a query param (writes also accept it in the body). Find it via GET
        /auth/me/ → organizations[].id.
  schemas:
    HomeAction:
      type: object
      description: >
        One Home Action. Identical item shape to GET
        /automation/recommendations/. `summary` is an alias of `why`. First-run
        rows have opportunity=null.
      properties:
        id:
          type: string
          format: uuid
        title:
          type: string
        why:
          type: string
        summary:
          type: string
        effect:
          type: string
          enum:
            - suggest_accept
            - approve_only
            - send
            - publish
            - schedule
        action_label:
          type: string
        effect_note:
          type: string
        is_external:
          type: boolean
        status:
          type: string
          enum:
            - pending
            - viewed
            - acted
            - dismissed
        payload:
          type: object
        related_type:
          type: string
          nullable: true
        related_id:
          type: string
          nullable: true
        source_mode:
          type: string
        created_at:
          type: string
          format: date-time
        type:
          type: string
        actions:
          type: array
          items:
            type: object
        editable:
          type: boolean
        opportunity:
          type: object
          nullable: true
        artifacts:
          type: array
          items:
            type: object
  securitySchemes:
    TokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'DRF user token. Format: `Token <token>`'

````