Criar demanda

Cria uma nova demanda para uma missão. O controller valida obrigatoriamente os campos `missionMainId`, `datePicked` e `participants`. No fluxo real do service, normalmente também são necessários: - `storesIds` - `scheduledAt` - `shifts` - `formId` ou `formPdvId`, dependendo do tipo da missão - `custom_fields`, se houver Para missões do tipo workforce: - `storesIds` deve conter IDs de `workforce_stores` - `formId` só é necessário se a subcategoria exigir formulário - `shifts` deve seguir o formato `day-start-end-index` - a subcategoria precisa estar com `check_in_check_out = true`

Authorization

clientIdAuth clientSecretAuth

client-id<token>

Client ID gerado na plataforma Mission Brasil.

In: header

client-secret<token>

Client Secret gerado na plataforma Mission Brasil.

In: header

Request Body

application/json

missionMainId*string

ID principal da missão.

Formatuuid

datePicked*string

Data selecionada para a demanda no formato YYYY-MM-DD.

Formatdate

scheduledAt?string

Data e hora agendada para execução da demanda.

Formatdate-time

participants*integer

Quantidade de participantes da demanda.

Range1 <= value

storesIds?array<integer>

Lista de IDs das lojas relacionadas à demanda.

shifts?array<string>

Lista de turnos no formato day-start-end-index.

formId?string

ID do formulário associado à missão, quando exigido.

Formatuuid

formPdvId?string

ID do formulário PDV, quando aplicável ao tipo de missão.

Formatuuid

custom_fields?

Campos adicionais customizados enviados com a demanda.

[key: string]?any

Response Body

`application/json`

curl -X POST "https://api.missionbrasil.com.br/v1/missions/demands" \
  -H "Content-Type: application/json" \
  -d '{
    "missionMainId": "7f0a6f64-9c2c-4ed8-8af8-e2545690f0a2",
    "datePicked": "2026-04-12",
    "scheduledAt": "2026-04-12T09:00:00.000Z",
    "participants": 2,
    "storesIds": [
      101,
      102
    ],
    "shifts": [
      "friday-17:00-23:00-1"
    ],
    "formId": "2d3f4c5b-6a7e-4890-b111-222233334444",
    "custom_fields": {
      "fields": [
        {
          "field": "uniforme",
          "value": "preto"
        },
        {
          "field": "observacao",
          "value": "Levar crachá e celular carregado"
        }
      ]
    }
  }'

curl -X POST "https://api.missionbrasil.com.br/v1/missions/demands" \  -H "Content-Type: application/json" \  -d '{    "missionMainId": "7f0a6f64-9c2c-4ed8-8af8-e2545690f0a2",    "datePicked": "2026-04-12",    "scheduledAt": "2026-04-12T09:00:00.000Z",    "participants": 2,    "storesIds": [      101,      102    ],    "shifts": [      "friday-17:00-23:00-1"    ],    "formId": "2d3f4c5b-6a7e-4890-b111-222233334444",    "custom_fields": {      "fields": [        {          "field": "uniforme",          "value": "preto"        },        {          "field": "observacao",          "value": "Levar crachá e celular carregado"        }      ]    }  }'

Empty

{
  "error": "missionMainId, datePicked and participants are required"
}

{
  "error": "Client ID ou Client Secret inválido ou ausente."
}

Criar demanda

Authorization

Request Body

Response Body

201

400application/json

401application/json

`application/json`

`application/json`