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

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

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

from*string

[Required] ID do usuário criador da tarefa. Deve pertencer ao escritório autenticado.

guests*array<>

[Required] Array com IDs dos usuários responsáveis pela tarefa. Mínimo 1 usuário. Todos devem pertencer ao escritório autenticado.

Items1 <= items

tasks_id*string

[Required] ID do tipo de tarefa.

lawsuits_id*string

[Required] ID do processo ao qual a tarefa está associada.

start_date*string

[Required] Data de início da tarefa. Aceita formatos YYYY-MM-DD ou DD/MM/YYYY.

start_time?string

[Optional] Hora de início da tarefa (formato HH:MM).

end_date?string

[Optional] Data de término da tarefa. Aceita formatos YYYY-MM-DD ou DD/MM/YYYY.

end_time?string

[Optional] Hora de término da tarefa (formato HH:MM).

date_deadline?string

[Optional] Data de prazo da tarefa. Aceita formatos YYYY-MM-DD ou DD/MM/YYYY.

local?string

[Optional] Local onde a tarefa será realizada.

comments?string

[Optional] Observações ou descrição detalhada da tarefa.

urgent?boolean

[Optional] Flag indicando se a tarefa é urgente.

important?boolean

[Optional] Flag indicando se a tarefa é importante.

display_schedule?boolean

[Optional] Flag indicando se a tarefa deve ser exibida na agenda.

Response Body

`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": "2025-01-15"  }'

{
  "success": true,
  "posts_id": 180922743
}

{
  "message": "The given data was invalid.",
  "errors": {
    "from": [
      "The sender user is required"
    ]
  }
}

{
  "error": "Unauthenticated."
}

Criar nova tarefa

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

Campo 'from' faltando

Campo 'guests' faltando

Array 'guests' vazio

Formato de data inválido

Usuário 'from' não pertence ao escritório

Guest não pertence ao escritório

Tarefa duplicada

Múltiplos erros

`application/json`

`application/json`

`application/json`