> ## Documentation Index
> Fetch the complete documentation index at: https://docs.melso.ai/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Melso product MCP: https://melso.ai/api/mcp (OAuth; one company per grant). REST: https://melso.ai. Documentation-search MCP: https://docs.melso.ai/mcp. The docs search server does not act on customer accounts.
>
> Use the live tool schema and respect company membership. Ask the person to authorize the exact fiscal document version in the signed-in app. A professional prepares and files included returns after authorization; AI does not file alone. A prepared file or approval receipt is not evidence of filing. Never claim completion from an accepted Task or Run. Keep credentials out of chat and logs. Agents features are internal or by private invitation.
# Send task input
> Workspace member with access to this resource.
Request: `content:string` required (not blank, no NUL characters), `attachment_ids?:UUID[]`, `client_request_id?:UUID`, `fresh_session?:boolean`, `max_attempts?:1`. Task path must be a UUID. The JSON body is limited to 1 MiB, and unknown fields are rejected.
Response: TaskInputResponse.
Status: 201, also for a replay; 400 blank or invalid content, an unknown field or a field of the wrong type, `max_attempts` other than 1, or a `client_request_id` that is not a UUID; 413 body over 1 MiB; 409 cancelled Task, missing execution settings, or a `client_request_id` already used with a different payload (`"code":"client_request_conflict"`). Authentication and resource-access errors follow [Overview](/api-reference/errors).
## OpenAPI
````yaml /api-reference/openapi.json post /api/tasks/{id}/input
openapi: 3.1.0
info:
title: Melso API
version: '2026-10-12'
description: >-
Customer integration contracts for Melso. Agents access is internal or by
private invitation. Fiscal approval remains in the authenticated app.
contact:
name: Melso
url: https://melso.ai/en
servers:
- url: https://melso.ai
description: Production API origin
security: []
tags:
- name: Areas
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Areas operations available within the caller's documented permissions.
- name: Artifacts
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Artifacts operations available within the caller's documented permissions.
- name: Authentication
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Authentication operations available within the caller's documented
permissions.
- name: Automations
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Automations operations available within the caller's documented
permissions.
- name: Companies
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Companies operations available within the caller's documented permissions.
- name: Execution funding
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Execution funding operations available within the caller's documented
permissions.
- name: Files
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Files operations available within the caller's documented permissions.
- name: GitHub
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
GitHub operations available within the caller's documented permissions.
- name: Interactions
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Interactions operations available within the caller's documented
permissions.
- name: Knowledge
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Knowledge operations available within the caller's documented permissions.
- name: MCP
description: MCP operations available within the caller's documented permissions.
- name: Messages
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Messages operations available within the caller's documented permissions.
- name: OAuth
description: OAuth operations available within the caller's documented permissions.
- name: Private network
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Private network operations available within the caller's documented
permissions.
- name: Runs
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Runs operations available within the caller's documented permissions.
- name: Skills
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Skills operations available within the caller's documented permissions.
- name: Tasks
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Tasks operations available within the caller's documented permissions.
- name: Vault
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Vault operations available within the caller's documented permissions.
- name: Webhooks
description: >-
Melso Agents is available only internally or by private invitation.
Agents-specific features require existing access. For the autónomo fiscal
service, see [Get started](/essentials/quickstart).
Webhooks operations available within the caller's documented permissions.
paths:
/api/tasks/{id}/input:
post:
tags:
- Messages
summary: Send task input
description: >-
Workspace member with access to this resource.
Request: `content:string` required (not blank, no NUL characters),
`attachment_ids?:UUID[]`, `client_request_id?:UUID`,
`fresh_session?:boolean`, `max_attempts?:1`. Task path must be a UUID.
The JSON body is limited to 1 MiB, and unknown fields are rejected.
Response: TaskInputResponse.
Status: 201, also for a replay; 400 blank or invalid content, an unknown
field or a field of the wrong type, `max_attempts` other than 1, or a
`client_request_id` that is not a UUID; 413 body over 1 MiB; 409
cancelled Task, missing execution settings, or a `client_request_id`
already used with a different payload
(`"code":"client_request_conflict"`). Authentication and resource-access
errors follow [Overview](/api-reference/errors).
operationId: sendTaskInput
parameters:
- name: id
in: path
required: true
description: id from the corresponding authorized response.
schema:
type: string
- name: X-Workspace-ID
in: header
required: false
description: >-
Company UUID for a personal token on company-scoped operations. A
company API key already binds its company.
schema:
type: string
format: uuid
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TaskInputRequestInput'
example:
content: Include operating costs.
client_request_id: 8b2f6c1e-4a7d-4f5e-9c3b-1d2e3f4a5b6c
responses:
'201':
description: TaskInputResponse.
content:
application/json:
schema:
$ref: '#/components/schemas/TaskInputResponse'
'400':
description: Invalid request.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Authentication required.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Credential, company or resource access denied.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Resource unavailable to this caller.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'409':
description: Request failed; see the operation contract for the condition.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'413':
description: Request failed; see the operation contract for the condition.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Rate limited; respect Retry-After when present.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Server error.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- bearerAuth: []
components:
schemas:
TaskInputRequestInput:
type: object
properties:
execution:
anyOf:
- $ref: '#/components/schemas/TaskExecutionRequestInput'
- type: 'null'
mcp_servers:
$ref: '#/components/schemas/McpServerInputsInput'
content:
type: string
attachment_ids:
type: array
items:
type: string
client_request_id:
type: string
fresh_session:
type: boolean
max_attempts:
anyOf:
- type: integer
- type: 'null'
TaskInputResponse:
type: object
properties:
message_id:
type: string
run_id:
type: string
queued:
type: boolean
attachment_ids:
type: array
items:
type: string
created_at:
type: string
required:
- message_id
- run_id
- queued
- attachment_ids
- created_at
Error:
type: object
properties:
error:
type: string
code:
type: string
required:
- error
additionalProperties: true
TaskExecutionRequestInput:
type: object
properties:
funding_source:
type: string
provider_account_id:
type: string
harness:
type: string
worker_id:
type: string
model:
type: string
thinking_level:
type: string
service_tier:
type: string
max_attempts:
anyOf:
- type: integer
- type: 'null'
McpServerInputsInput:
type: array
items:
$ref: '#/components/schemas/McpServerInputInput'
maxItems: 10
description: >-
At most 10 servers with unique, non-reserved names. Each server uses
exactly one of a remote HTTPS url or a stdio command. headers belong to
remote servers; args and env belong to stdio servers. The encrypted set
is limited to 64 KiB; the server rejects a larger sealed set with HTTP
413. This encrypted-size limit cannot be measured as JSON character
count. Header and environment values are write-only; GET returns
McpServerSummary objects.
McpServerInputInput:
type: object
properties:
name:
type: string
pattern: ^[a-z0-9][a-z0-9-]{0,62}$
url:
type: string
headers:
type: object
additionalProperties:
type: string
command:
type: string
args:
type: array
items:
type: string
env:
type: object
additionalProperties:
type: string
required:
- name
additionalProperties: false
description: >-
Remote input: name, url and optional headers. Stdio input: name, command
and optional args and env. Exactly one nonempty url or command is
required. Unknown fields are rejected; transport-specific fields are
validated by the server.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Company API key (mwk_) or personal access token (mel_). A PAT requires
X-Workspace-ID on company-scoped routes. An API key implies its own
company.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.