# Entity Subscription Endpoints {#entity-subscription-endpoints}


Subscribe to entities (tasks, projects, etc.) to receive notifications when changes occur.


## Base Path {#base-path}


```
/api/entity-subscription
```


## Endpoints {#endpoints}



### List Subscriptions {#list-subscriptions}


```
GET /api/entity-subscription
Authorization: Bearer {token}
```


### Create Subscription {#create-subscription}


```
POST /api/entity-subscription
Authorization: Bearer {token}
Content-Type: application/json

{
  "entity": "Task",
  "entityId": "task-uuid",
  "type": "COMMENT"
}
```


### Delete Subscription {#delete-subscription}


```
DELETE /api/entity-subscription/:id
Authorization: Bearer {token}
```


## Subscription Types {#subscription-types}


| Type         | Notification Trigger  |
| ------------ | --------------------- |
| `COMMENT`    | New comment on entity |
| `STATUS`     | Status change         |
| `ASSIGNMENT` | Assignment change     |
| `ALL`        | All changes           |


## Data Model {#data-model}


```typescript
interface IEntitySubscription {
  id: string;
  entity: string;
  entityId: string;
  type: EntitySubscriptionTypeEnum;
  employeeId: string;
  organizationId: string;
  tenantId: string;
}
```


## Related Pages {#related-pages}


- [Entity Subscriptions Feature](https://sourcey-gauzy.pages.dev/features/entity-subscriptions/index.md) — feature guide
- [Employee Notifications](https://sourcey-gauzy.pages.dev/features/employee-notifications/index.md) — notification system