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 tarefalawsuits_id: ID do processostart_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
guestsnão pode ser vazio (mínimo 1 usuário) - Guests podem incluir o próprio criador
Horário de término:
end_datepode ser enviado sozinhoend_timerequerend_datejunto — sem ele o horário de término é ignorado
Retorno: Em caso de sucesso, retorna status 200 com ID da tarefa criada.
Authorization
BearerAuth 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"
}