Skip to main content
POST
Add a message to a case
Live capability. Melso runs this in production today. Partner keys reach it once your partner account is enabled. See Availability.
With changes true, it asks for changes to the version waiting for approval and returns the case to review.

Authorizations

Authorization
string
header
required

Your partner secret key, mk_live_… for real companies or mk_test_… for test companies. Keep it on your servers. See Authentication.

Headers

Idempotency-Key
string

A unique key, such as a UUID, that makes a retried create safe. Reusing a key with a different body is refused.

Maximum string length: 255

Path Parameters

company_id
string<uuid>
required

The company's ID. Every company-scoped call works in exactly this company.

case_id
string<uuid>
required

Body

application/json
content
string
Maximum string length: 20000
file_ids
string<uuid>[]
Maximum array length: 20
changes
boolean
default:false

Response

The case with the new message.

id
string<uuid>
required
kind
enum<string>
required

modelo: prepare and file one AEAT form for one period (details model, period); an empresa cannot ask for the 130, 131 or 100. alta: register an autónomo with the AEAT and the Social Security (details start_date, activity). renta: an autónomo's annual income tax return, modelo 100 (details year, joint). constitucion_sl: incorporate an S.L. or S.L.U., paid once by the owner before Melso starts. More kinds are added over time; read them from List case kinds.

Available options:
modelo,
alta,
renta,
constitucion_sl
status
enum<string>
required

draft: not sent yet. review: Melso's professionals are working on it. info: they asked the company for something (information_request). approval: a draft waits for the company's approval. filing: approved, being filed. done: filed, with the administration's external_reference. cancelled: withdrawn before filing.

Available options:
draft,
review,
info,
approval,
filing,
done,
cancelled
created_at
string<date-time>
required
deadline
string<date> | null
current_version
integer | null
approved_version
integer | null
payment_url
string<uri> | null

Where the owner pays a service kind before Melso starts.

information_request
object | null

What the professionals need from the company, with the items to answer.

messages
object[]
documents
object[]

The professionals' drafts, the company's documents and the filing receipts.

external_reference
string | null

The administration's reference for what was filed. Always present once done.

completed_on
string<date> | null
updated_at
string<date-time>