# Proposal Endpoints {#proposal-endpoints}


Manage sales proposals for clients.


## Base Path {#base-path}


```
/api/proposal
```


## Endpoints {#endpoints}



### List Proposals {#list-proposals}


```
GET /api/proposal
Authorization: Bearer {token}
```

**Query Parameters:**

| Parameter        | Type   | Description                     |
| ---------------- | ------ | ------------------------------- |
| `page`           | number | Page number                     |
| `limit`          | number | Items per page                  |
| `status`         | string | DRAFT, SENT, ACCEPTED, REJECTED |
| `organizationId` | string | Organization filter             |


### Create Proposal {#create-proposal}


```
POST /api/proposal
Authorization: Bearer {token}
```

```json
{
  "jobPostUrl": "https://example.com/job",
  "valueDate": "2025-03-05",
  "jobPostContent": "Full-stack developer position",
  "proposalContent": "We propose to deliver...",
  "status": "SENT",
  "organizationContactId": "contact-uuid"
}
```


### Update Proposal {#update-proposal}


```
PUT /api/proposal/:id
Authorization: Bearer {token}
```


### Delete Proposal {#delete-proposal}


```
DELETE /api/proposal/:id
Authorization: Bearer {token}
```


## Proposal Statuses {#proposal-statuses}


| Status   | Description     |
| -------- | --------------- |
| DRAFT    | Not yet sent    |
| SENT     | Sent to client  |
| ACCEPTED | Client accepted |
| REJECTED | Client rejected |


## Related Pages {#related-pages}


- [Proposals Management](https://sourcey-gauzy.pages.dev/features/proposals-management/index.md) — feature
- [Contact Endpoints](https://sourcey-gauzy.pages.dev/api/contact-endpoints/index.md) — contacts API