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

# Activity Endpoints

> Action logging and event tracking for organizations

> **Source:** `equa-server/modules/api/src/endpoints/activity-endpoints.ts`

# Activity Endpoints

Endpoints for recording and retrieving activity logs within an organization. Activity logs track user actions like creating shareholdings, updating members, and modifying cap table data.

All activity endpoints require authentication and `canViewOrganization` permission.

## Create Action

```
POST /v1/organization/:organization/action
```

| Field      | Value                 |
| ---------- | --------------------- |
| Auth       | Required              |
| Permission | `canViewOrganization` |

Record a new action in the organization's activity log.

**Request:**

```json theme={null}
{
  "type": "shareholding.created",
  "description": "Created shareholding for Jane Doe",
  "metadata": {
    "shareholdingId": "uuid",
    "memberId": "uuid"
  }
}
```

***

## List Actions

```
GET /v1/organization/:organization/action
```

| Field      | Value                 |
| ---------- | --------------------- |
| Auth       | Required              |
| Permission | `canViewOrganization` |

Retrieve the activity log for an organization.

**Response:**

```json theme={null}
[
  {
    "id": "uuid",
    "type": "shareholding.created",
    "description": "Created shareholding for Jane Doe",
    "userId": "uuid",
    "created": "2025-06-15T10:30:00Z",
    "metadata": {}
  }
]
```