Skip to Content
Prets Developer Portal

Create a case for a quote

POST
/v1/quotes/{quoteId}/cases

to try read requests with your account, or paste an API key into the Authorization field. Create an API key in the Partner Portal.

Opens a case on a quote to ask Prets a question or request an action, such as rescheduling a meeting or cancelling the application. The opening message becomes the case's first message, and subject defaults to its first line.

Returns the created case. Your organization can have one open case of its own per quote: while one is open, this returns 409 with a Location header pointing at it. Returns 404 when the quote does not exist or is not visible to you.

Path Parameters

quoteId*string

Quote ID

Match^qot_[0-9A-HJKMNP-TV-Z]{26}$

Request Body

application/json
  1. body

Open a general-support Case. The opening text is the first message.

type*"general"

General-support Case with no request type

Value in"general"
caseId?string

Client-generated id (cas_{ULID}). When provided the server uses this as the canonical case ID, enabling optimistic UI.

Match^cas_[0-9A-HJKMNP-TV-Z]{26}$
subject?string

Case subject (max 255 characters). When omitted, derived from the first line of the opening message.

Length1 <= length <= 255
message*

Opening or reply message body. Optional client ULID for idempotent create.

Response Body

The created case

application/json
  1. response

Created support case

data*||

Quote support Case. Conversation lives on /messages; this resource is metadata and lifecycle only.

Authorization

bearerAuth
headerAuthorizationBearer <token>
Example Request
curl -X POST 'https://api.prets.app/v1/quotes/qot_01ARZ3NDEKTSV4RRFFQ69G5FAV/cases' \  -H 'Content-Type: application/json' \  -d '{  "type": "general",  "message": {    "body": "The customer asked to move the appointment to next week."  }}'
Example Response
{  "data": {    "caseId": "cas_01ARZ3NDEKTSV4RRFFQ69G5FAV",    "quote": {      "quoteId": "qot_01ARZ3NDEKTSV4RRFFQ69G5FAV"    },    "type": "merchant_feedback",    "requestType": "Reschedule Meeting",    "subject": "Customer wants a later install date",    "description": "The customer asked to move the appointment.",    "stage": "Prets Action",    "createdAt": "2026-08-14T09:12:04.000Z",    "expiresAt": "2026-09-09",    "createdBy": "Jane Advisor",    "updatedAt": "2026-08-16T11:03:22.000Z",    "state": "open",    "waitingOn": "prets",    "waitingSince": "2026-08-14T09:12:04.000Z"  }}