Criar tarefa - Sensio API

Autenticação: envie Authorization: Bearer <chave da API pública do Sensio>. A chave deve estar vinculada de forma única a um usuário ativo da empresa. O servidor utiliza as permissões atuais desse usuário e determina a autoria; não envie company, user ou permissões no corpo.

Cria uma tarefa na empresa autenticada. title e type são obrigatórios. Para PO, Person, Sale e Transaction, informe um documentId existente e não removido da mesma empresa; a permissão de edição correspondente é exigida. Para Standalone, omita o documento. poId, quando informado em uma tarefa PO, deve ser idêntico a documentId.

Os membros precisam ser usuários ativos da empresa. São aceitos IDs ou objetos contendo somente userId, com até 100 entradas; duplicatas são eliminadas. Datas devem ser ISO válidas e o início não pode ser posterior ao prazo. Quando há prazo sem início, a criação usa o mesmo dia para ambos.

body é texto simples, com até 100000 caracteres. HTML é tratado como texto e não provoca download de imagens remotas. Descrições nas respostas públicas são devolvidas como texto.

Campos extras são rejeitados. A empresa, o autor, os históricos e a data de criação são definidos pelo servidor. Falhas posteriores de notificação não desfazem uma criação concluída.

Todas as operações respeitam a empresa autenticada. Tarefas de calendário do tipo Carga não são expostas. A API usa os limites de consumo existentes: 25 requisições por minuto por empresa.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Tarefa vinculada a uma OPTarefa avulsa sem documento

{
    "title": "Revisar produção",
    "type": "PO",
    "documentId": "507f1f77bcf86cd799439011",
    "body": "Conferir o material antes de iniciar.",
    "previsionEnd": "2026-11-10",
    "members": [
        "507f1f77bcf86cd799439012"
    ]
}

Códigos de solicitação

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢201Criado

application/json

Tarefa criada; o autor é o usuário vinculado à chave.

Bodyapplication/json

Exemplo

{
    "success": true,
    "response": {
        "_id": "507f1f77bcf86cd799439010",
        "title": "Revisar produção",
        "type": "PO",
        "documentId": "507f1f77bcf86cd799439011",
        "poId": "507f1f77bcf86cd799439011",
        "body": "Conferir o material antes de iniciar.",
        "previsionStart": "2026-11-10T00:00:00.000Z",
        "previsionEnd": "2026-11-10T00:00:00.000Z",
        "dateCreated": "2026-11-04T15:00:00.000Z",
        "isCompleted": false,
        "blockedDate": false,
        "user": "507f1f77bcf86cd799439012",
        "members": [
            {
                "userId": "507f1f77bcf86cd799439012",
                "name": "Usuário responsável"
            }
        ],
        "company": "507f1f77bcf86cd799439013",
        "attachments": [],
        "observations": [],
        "updatesCompleted": []
    }
}

🟠400Pedido Inválido

🟠401Não Autorizado

🟠402Plano da empresa expirado

🟠403Proibido

🟠409A OP deixou de estar disponível durante a criação; a tarefa sem vínculo é removida

🟠429Limite de consumo da API atingido

🔴500Erro do Servidor