Lelemon
  • Get started
  • Use cases
  • Guides
  • API basics
  • Webhooks
  • SDK, CLI and MCP
  • API reference
  • Changelog
  • v1 (legacy)
Information
Me
    Retrieve the current keyget
API keys
    List scopesget
Agents
    List agentsgetCreate an agentpostRetrieve an agentgetDelete an agentdeleteUpdate an agentpatchActivate an agentpostPause an agentpostList versionsgetRetrieve a versiongetRestore a versionpostList the fixed facts of an agentgetSave a fixed fact of an agentputForget a fixed fact of an agentdelete
Models and templates
    List agent templatesgetList modelsget
Subaccounts
    List subaccountsgetCreate a subaccountpostRetrieve a subaccountgetDelete a subaccountdeleteUpdate a subaccountpatchGive a subaccount its own keypost
WhatsApp
    List WhatsApp connectionsgetCreate a WhatsApp connection linkpostRetrieve a WhatsApp connectiongetRevoke a pending WhatsApp connectiondeleteList WhatsApp phone numbersgetRetrieve a WhatsApp phone numbergetDisconnect a WhatsApp phone numberdeleteChange the agent, label or state of a numberpatchRead the cart and catalog settings of a numbergetTurn the cart button or the catalog icon of a number on or offpatch
Actions
    List actionsgetCreate an actionpostRead the current authorization textgetRotate the signing secret of your actionspostRetrieve the signing secret of an actiongetRetrieve an actiongetDelete an actiondeleteUpdate an actionpatchTest an actionpostRead the approval floor of a shared actiongetSet the approval floor of a shared actionput
MCP servers
    List MCP serversgetConnect an MCP serverpostRetrieve an MCP servergetDisconnect an MCP serverdeleteUpdate an MCP serverpatchList the tools of an MCP servergetDiscover toolspostRead the run identity of an MCP servergetTurn on or rotate the run identity of an MCP serverpostTurn off the run identity of an MCP serverdelete
Data connectors
    Get the lelemon-connector/v1 formatgetValidate a connector documentpostList data connectorsgetRegister a data connectorpostRetrieve a data connectorgetDelete a data connectordeleteUpdate a data connectorpatchRetrieve the signing secret of a data connectorgetRotate the signing secret of a data connectorpostCheck a data connectorpostRetrieve the manifest of a data connectorgetSearch accounts by emailgetRead the card of an account livegetReveal one masked value of an accountpostGet the link of an account actionpostRead a view livegetList who looked at what through a connectorget
Skills
    List skillsgetCreate a skillpostRetrieve a skillgetDelete a skilldeleteUpdate a skillpatch
Agent tools
    List an agent's toolsgetGrant a toolputRemove a tooldelete
Approvals
    List approvalsgetRetrieve an approvalgetApprove an actionpostReject an actionpostAsk for a human review of a decisionpost
Automated decisions
    List automated decisionsgetRetrieve an automated decisiongetAsk for a human review of an automated decisionpost
Team questions
    List team questionsgetRetrieve a team questiongetRead a team question with its contextgetAnswer a team questionpost
Runs
    Give an agent a jobpostList runsgetRetrieve a rungetCancel a runpostAnswer a run that asked somethingpost
Schedules
    Schedule a job for an agentpostList scheduled tasksgetRetrieve a scheduled taskgetDelete a scheduled taskdeleteChange a scheduled taskpatchFire a scheduled task nowpost
Pipelines
    List pipelinesgetCreate a pipelinepostRetrieve a pipelinegetDelete a pipelinedeleteUpdate a pipelinepatchClone a pipelinepostReorder the stages of a pipelinepost
Stages
    List the stages of a pipelinegetCreate a stagepostRetrieve a stagegetDelete a stagedeleteUpdate a stagepatchMake a stage the entry stagepost
Fields
    List the fields of a pipelinegetCreate a fieldpostRetrieve a fieldgetDelete a fielddeleteUpdate a fieldpatch
Routing rules
    List the routing rules of a pipelinegetCreate a routing rulepostRetrieve a routing rulegetDelete a routing ruledeleteUpdate a routing rulepatch
Knowledge
    List collectionsgetCreate a collectionpostSearch the knowledgepostRetrieve a collectiongetDelete a collectiondeleteUpdate a collectionpatchList documentsgetAdd a documentpostRetrieve a documentgetDelete a documentdeleteUpdate a documentpatchLet an agent search a collectionputStop an agent from searching a collectiondelete
Contacts
    List contactsgetCreate a contactpostCreate or update a contact by your own idputRetrieve a contactgetErase a contactdeleteUpdate a contactpatch
Contact fields
    List the contact fieldsgetCreate a contact fieldpostRetrieve a contact fieldgetDelete a contact fielddeleteUpdate a contact fieldpatch
Companies
    List companiesgetCreate a companypostRetrieve a companygetDelete a companydeleteUpdate a companypatch
Lead forms
    List lead formsgetCreate a lead formpostRetrieve a lead formgetDelete a lead formdeleteUpdate a lead formpatch
Suppressions
    Retrieve a suppressionget
Cases
    List casesgetOpen a casepostRetrieve a casegetDelete a casedeleteUpdate a casepatchMove a case to a stagepostAssign a case to a memberpostClose a casepostReopen a casepostTake control of a casepostHand a case back to the agentpostMark a case as readpostMove several cases to a stagepostArchive a casepostBring an archived case backpostMute the contact of a casepostUnmute the contact of a casepostHand a case to a personpostReveal a sensitive field of a casepostEscalate a case to the technical teampostList the escalations of a caseget
Case queue
    Read the attention queue of a memberget
Contact events
    List the events of a contactgetReport a contact eventpostRetrieve a contact eventget
Case reminders
    List the reminders of a casegetAdd a reminder to a casepost
Reminders
    Retrieve a remindergetDelete a reminderdeleteEdit a reminderpatchComplete a reminderpostDismiss a reminderpost
Presence
    Report who is online in your apppostRead the presence settinggetTurn presence on or offput
Organization
    Get the organizationgetRename the organizationpatchGet the organization settingsgetChange the organization settingspatchGet the company profilegetChange the company profilepatch
Case notes
    List the notes of a casegetAdd a note to a casepostRetrieve a notegetDelete a notedeleteEdit a notepatch
Case attachments
    List the files of a casegetUpload a file to a casepostRetrieve a file of a casegetDelete a file of a casedeleteGet the download link of a fileget
Files
    List filesgetUpload a filepostRetrieve a filegetDelete a filedelete
Case messages
    List the messages of a casegetAdd a message to a casepostRedact a messagepost
Case turns
    List the turns the agent took in a caseget
Usage
    Get the usage of your agentsget
Case metrics
    List the times of the cases that changed in a rangeget
Budgets
    List the budgetsgetCreate a monthly budgetpostGet a budgetgetDelete a budgetdeleteChange a budgetpatch
Members
    List the active members of the organizationgetList who invited, changed the role of or removed membersgetRead whether a team member is availablegetMark a team member available or awayputChange the role of a memberpatchChange which cases a member seespatchRemove a member from the organizationdelete
Invitations
    List the invitations of the organizationgetInvite a person to the organizationpostResend an invitationpostCancel an invitationpost
Scheduling
    List the agendasgetCreate an agendapostRetrieve an agendagetUpdate an agendapatchList the team of an agendagetAdd a person to the team of an agendapostRemove a person from the team of an agendadeleteUpdate a person in the team of an agendapatchRead the free slots of an agendagetList meetingsgetBook a meetingpostRetrieve a meetinggetCancel a meetingpostMove a meeting to another slotpost
Webhook endpoints
    List webhook endpointsgetCreate a webhook endpointpostRetrieve a webhook endpointgetDelete a webhook endpointdeleteUpdate a webhook endpointpatchRotate the signing secretpostSend a test eventpostList the deliveries of an endpointget
Events
    Resend an eventpostList the event typesget
Recipient allowlist
    Get the recipient allowlistgetReplace the recipient allowlistput
WhatsApp templates
    List templatesgetCreate a templatepostSync template statusespostRetrieve a templategetDelete a templatedeleteUpdate a templatepatchRender a templatepostSend a test messagepost
WhatsApp messages
    Send a templatepostRetrieve a template messagegetCancel a scheduled messagepost
Triggers
    List triggersgetCreate a triggerpostRetrieve a triggergetDelete a triggerdeleteUpdate a triggerpatchList the runs of a triggerget
Opt-outs
    List opt-outsgetOpt a contact outputClear an opt-outdelete
Campaigns
    List campaignsgetCreate a campaignpostRetrieve a campaigngetDelete a campaigndeleteUpdate a campaignpatchPreview a campaignpostLaunch a campaignpostPause a campaignpostResume a campaignpostCancel a campaignpostList recipientsget
Email domains
    List the sender domainsgetAdd a sender domainpostGet a sender domain with its status and DNS recordsgetRemove a sender domaindeleteChange the default sender or the inbound agent of a domainpatchCheck the DNS records nowpost
Email messages
    Write first by emailpostRetrieve an email messageget
Teams
    List the teamsgetCreate a teampostRetrieve a teamgetDelete a teamdeleteUpdate a teampatchMerge another team into this onepostMove a pipeline into a teamputAdd a member to a team or change their role in itputRemove a member from a teamdelete
Linear
    Get the Linear connectiongetConnect LinearputDisconnect LineardeleteUpdate the Linear connectionpatch
Schemas
powered by Zudoku
Lelemon API
Lelemon API

Case attachments


List the files of a case

GET
https://api.lelemon.cl
/v2/cases/{id}/attachments
Bearer (API key)

Newest first.

Required scope: cases:read.

List the files of a case › path Parameters

id
​string · pattern: ^cse_[0-9A-Za-z]{22}… · required

The id of the case (cse_…).

List the files of a case › query Parameters

limit
​integer · min: 1 · max: 100
Default: 20
cursor
​string · maxLength: 512

The nextCursor of the previous page, with the same filters.

List the files of a case › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

List the files of a case › Responses

AttachmentList
object
​string · enum · required
Enum values:
list
hasMore
​boolean · required
nextCursor
​string | null · required
​Attachment[] · required
GET/v2/cases/{id}/attachments
curl https://api.lelemon.cl/v2/cases/:id/attachments \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "list", "hasMore": true, "nextCursor": "nextCursor", "data": [ { "object": "attachment", "id": "att_4Zq0x8bVw1TqS9mYp3RkLd", "caseId": "cse_4Zq0x8bVw1TqS9mYp3RkLd", "filename": "contract.pdf", "mimeType": "application/pdf", "sizeBytes": 0, "source": "manual", "createdAt": "2024-08-25T15:00:00Z" } ] }
json
application/json

Upload a file to a case

POST
https://api.lelemon.cl
/v2/cases/{id}/attachments
Bearer (API key)

Multipart, with the file in the file field. PDF, images, Word, Excel, CSV, XML and text, up to 10 MB.

Required scope: cases:write.

Upload a file to a case › path Parameters

id
​string · pattern: ^cse_[0-9A-Za-z]{22}… · required

The id of the case (cse_…).

Upload a file to a case › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Idempotency-Key
​string · minLength: 1 · maxLength: 255

Makes the request safe to retry. Once it starts running, its final response (2xx, 4xx or 5xx) is kept for 24 hours and the same key gets it back, without repeating the effect. A request rejected before it runs leaves the key free. A replayed create omits the secret. The same key with a different request is rejected with 409 idempotency_key_reused.

Upload a file to a case › Request Body

file
​string · binary · required

Upload a file to a case › Responses

Attachment
object
​string · enum · required
Enum values:
attachment
id
​string · required
caseId
​string · required
filename
​string · required
mimeType
​string · required
sizeBytes
​integer · required
source
​string · enum · required

manual is uploaded by API or by the team.

Enum values:
manual
whatsapp
note
createdAt
​string · date-time · required
POST/v2/cases/{id}/attachments
curl https://api.lelemon.cl/v2/cases/:id/attachments \ --request POST \ --header 'Content-Type: multipart/form-data' \ --header 'Authorization: Bearer <token>' \ --form 'file=<binary>'
Example Request Body
{ "file": "<binary>" }
text
Example Responses
{ "object": "attachment", "id": "att_4Zq0x8bVw1TqS9mYp3RkLd", "caseId": "cse_4Zq0x8bVw1TqS9mYp3RkLd", "filename": "contract.pdf", "mimeType": "application/pdf", "sizeBytes": 0, "source": "manual", "createdAt": "2024-08-25T15:00:00Z" }
json
application/json

Retrieve a file of a case

GET
https://api.lelemon.cl
/v2/cases/{id}/attachments/{attachmentId}
Bearer (API key)

Returns one file of a case by id. Use it to refresh a single record you already know; to find records, use the list route. To get the bytes, use the download route of the file. Read only. 404 not_found when the id does not exist or belongs to another organization. You can repeat it safely: it has no side effects.

Required scope: cases:read.

Retrieve a file of a case › path Parameters

id
​string · pattern: ^cse_[0-9A-Za-z]{22}… · required

The id of the case (cse_…).

attachmentId
​string · pattern: ^att_[0-9A-Za-z]{22}… · required

The id of the attachment (att_…).

Retrieve a file of a case › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Retrieve a file of a case › Responses

Attachment
object
​string · enum · required
Enum values:
attachment
id
​string · required
caseId
​string · required
filename
​string · required
mimeType
​string · required
sizeBytes
​integer · required
source
​string · enum · required

manual is uploaded by API or by the team.

Enum values:
manual
whatsapp
note
createdAt
​string · date-time · required
GET/v2/cases/{id}/attachments/{attachmentId}
curl https://api.lelemon.cl/v2/cases/:id/attachments/:attachmentId \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "attachment", "id": "att_4Zq0x8bVw1TqS9mYp3RkLd", "caseId": "cse_4Zq0x8bVw1TqS9mYp3RkLd", "filename": "contract.pdf", "mimeType": "application/pdf", "sizeBytes": 0, "source": "manual", "createdAt": "2024-08-25T15:00:00Z" }
json
application/json

Delete a file of a case

DELETE
https://api.lelemon.cl
/v2/cases/{id}/attachments/{attachmentId}
Bearer (API key)

Deletes a file attached to a case. Messages that already carried it keep their record. The effect is permanent through the API. Repeating the call returns 404 not_found, because the file no longer exists, so do not retry a 404 as a failure.

Required scope: cases:write.

Delete a file of a case › path Parameters

id
​string · pattern: ^cse_[0-9A-Za-z]{22}… · required

The id of the case (cse_…).

attachmentId
​string · pattern: ^att_[0-9A-Za-z]{22}… · required

The id of the attachment (att_…).

Delete a file of a case › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Delete a file of a case › Responses

No data returned
DELETE/v2/cases/{id}/attachments/{attachmentId}
curl https://api.lelemon.cl/v2/cases/:id/attachments/:attachmentId \ --request DELETE \ --header 'Authorization: Bearer <token>'
Example Responses
No example specified for this content type

Get the download link of a file

GET
https://api.lelemon.cl
/v2/cases/{id}/attachments/{attachmentId}/download
Bearer (API key)

A signed link that lasts 10 minutes. Ask again for a new one.

Required scope: cases:read.

Get the download link of a file › path Parameters

id
​string · pattern: ^cse_[0-9A-Za-z]{22}… · required

The id of the case (cse_…).

attachmentId
​string · pattern: ^att_[0-9A-Za-z]{22}… · required

The id of the attachment (att_…).

Get the download link of a file › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Get the download link of a file › Responses

AttachmentDownload
object
​string · enum · required
Enum values:
attachment_download
url
​string · required

A signed link. Open it before expiresAt.

expiresAt
​string · date-time · required
GET/v2/cases/{id}/attachments/{attachmentId}/download
curl https://api.lelemon.cl/v2/cases/:id/attachments/:attachmentId/download \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "attachment_download", "url": "url", "expiresAt": "2024-08-25T15:00:00Z" }
json
application/json

Case notesFiles