ADVBOXAPI ADVBOX
Tasks

Criar nova tarefa

Cria uma nova tarefa no sistema associada a um processo e usuários responsáveis.

Campos Obrigatórios:

  • from: ID do usuário criador (deve pertencer ao escritório)
  • guests: Array com IDs dos responsáveis (mínimo 1, devem pertencer ao escritório)
  • tasks_id: ID do tipo de tarefa
  • lawsuits_id: ID do processo
  • start_date: Data de início (aceita YYYY-MM-DD ou DD/MM/YYYY)

Validações:

  • API valida se usuários pertencem ao escritório autenticado
  • API detecta e impede tarefas duplicadas
  • Array guests não pode ser vazio (mínimo 1 usuário)
  • Guests podem incluir o próprio criador

Horário de término:

  • end_date pode ser enviado sozinho
  • end_time requer end_date junto — sem ele o horário de término é ignorado

Retorno: Em caso de sucesso, retorna status 200 com ID da tarefa criada.

POST
/posts

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.advbox.com.br/api/v1/posts" \  -H "Content-Type: application/json" \  -d '{    "from": "12345",    "guests": [      12345,      67890    ],    "tasks_id": "100",    "lawsuits_id": "5000",    "start_date": "2026-04-02"  }'
{
  "success": true,
  "posts_id": 180922743
}
{
  "error": "Unauthenticated."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "lawsuits_id": [
      "The process is required"
    ],
    "start_date": [
      "The appointment date field is required"
    ],
    "from": [
      "The sender user is required"
    ],
    "tasks_id": [
      "The task field is required"
    ],
    "guests": [
      "Please provide the task assignees"
    ]
  }
}

{
  "message": "Too Many Requests"
}
{
  "message": "Server Error"
}