Skip to main content
POST
Attest a case approval from your interface
Planned. A preview contract for design partners. It is not callable yet, and fields can still change. See Access and pricing and Availability.
Access: REST, not callable yet · manual-assisted.
Manual-assisted when it ships. This planned workflow would support work by professionals under the company’s mandate. The operation is not callable yet.
You attest that the person who must approve it read exactly expected_version in your interface and approved it, and you send the evidence. Melso records the attestation with the evidence and treats it as that person’s approval, the same as on Melso’s approval page; you receive case.approved. A case whose version changed is refused. For an incorporation this approves the deed draft. It never stands in for signing the deed before the notary. Requires a signed partner agreement that defines who may approve and how evidence is kept.

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
expected_version
integer
required
Required range: x >= 1
approver
object
required
evidence
object
required

Response

The case, approved, with the attestation recorded.

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 (036) and the Social Security (RETA), details in CaseDetailsAlta; it has no draft to approve. renta: an autónomo's annual income tax return, modelo 100 (details year, joint). constitucion_sl: incorporate an S.L. or S.L.U., details in CaseDetailsConstitucionSL, paid once before Melso starts; the owner approves the deed draft. It opens only in a company in incorporation, which holds nothing else until the S.L. is registered. 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
approvals
object[]

Preview. Who approved which version, and how.

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>