API: record, change and delete offers, not only read them #1101

Closed
opened 2026-10-30 21:25:18 +00:00 by tiagoagueda · 0 comments
Owner

Offers can be read through the API but not recorded. The router says "Recording one is the interface's, for now (#237)", and #237 is closed, so the "for now" has no issue left to answer it.

What exists today

  • api/routers/offers.py: list and get only.
  • Offers are recorded, compared, edited and deleted in the interface.
  • postulo-mcp can change an application's status but cannot record the offer that comes with it.

What would change

  • POST /offers, PATCH /offers/{pk} and DELETE /offers/{pk} under the write scope, with the form's validation and the timeline entry the interface writes.
  • The OpenAPI description and the isolation sweep updated.

Decisions

  • Delete through the API. Recommended: yes, as the interface allows. postulo-mcp keeps its rule of never offering a delete tool.

Checked against main at daee30b15 (2026-10-30). From the status review and feature suggestions of 2026-10-30.

Offers can be read through the API but not recorded. The router says "Recording one is the interface's, for now (#237)", and #237 is closed, so the "for now" has no issue left to answer it. ## What exists today - `api/routers/offers.py`: list and get only. - Offers are recorded, compared, edited and deleted in the interface. - postulo-mcp can change an application's status but cannot record the offer that comes with it. ## What would change - `POST /offers`, `PATCH /offers/{pk}` and `DELETE /offers/{pk}` under the `write` scope, with the form's validation and the timeline entry the interface writes. - The OpenAPI description and the isolation sweep updated. ## Decisions - **Delete through the API.** Recommended: yes, as the interface allows. postulo-mcp keeps its rule of never offering a delete tool. Checked against `main` at `daee30b15` (2026-10-30). From the status review and feature suggestions of 2026-10-30.
tiagoagueda added this to the 0.6.0 milestone 2026-10-30 21:25:18 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Postulo/postulo#1101
No description provided.