> ## 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.

# Tasks

> Create and organize durable conversations. Execution happens in Runs.

<Info>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).</Info>

Create and organize durable conversations. Execution happens in Runs.

Read the [workflow guide](/concepts/tasks-api) before making changes. The endpoint pages below contain the request and response schemas.

Company membership and credential scope apply to every operation. Agents-only capabilities require existing private access. A company API key does not grant every route merely because it belongs to the company.

## Creation constraints

These field descriptions come from the `POST /api/tasks` request schema in the [OpenAPI contract](/api-reference/openapi.json). Use the endpoint pages for the full request and response shapes.

### metadata

`metadata`: A flat map of strings, numbers and booleans with at most 50 keys. Keys match ^\[a-zA-Z\_]\[a-zA-Z0-9\_.-]{0,63}\$. The encoded create value and stored JSONB each have an 8 KiB limit; storage size is checked by the server, not by a JSON Schema character limit. Null values, arrays and nested objects are rejected.

### instructions

`instructions`: Immutable guidance for every Run on the Task. At most 32768 UTF-8 bytes and no NUL characters. The server checks bytes, not Unicode character count. Run credentials cannot configure this field.

### MCP servers

`mcp_servers`: 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.

### repositories

`repositories`: At most 20 repository grants, fixed at Task creation. Requires an admin company key and an enabled integration broker. Each grant names a canonical GitHub HTTPS URL, read or write permission and a credential\_reference identifying an authorization grant, never a token. The broker response must contain token, expires\_at and permission matching the request. expires\_at must be more than 30 seconds and at most 70 minutes after the exchange validation time. This expiry rule applies to the broker response, not to a Task creation field.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.