# Cria um despacho

Cria um novo despacho a partir de um formulário Formly.

Controle de acesso por nível de permissão da API Key:
- tenant — o despacho é vinculado ao município da API Key; o campo cityId é ignorado.
- support — o campo cityId é obrigatório e define o município ao qual o despacho pertence.

Endpoint: POST /hub-api/blueprint-post
Security: InternalAuth

## Request fields (application/json):

  - `form` (object, required)
    Formulário Formly do despacho

  - `name` (string)
    Nome do despacho
    Example: "Despacho de Aprovação"

  - `cityId` (number)
    ID do município. Obrigatório para API Keys do tipo support; ignorado para tenant.
    Example: 42

## Response 201 fields (application/json):

  - `id` (string)
    Example: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"

  - `cityId` (number)
    Example: 42

  - `form` (object)

  - `name` (string)
    Example: "Despacho de Aprovação"

  - `disabled` (boolean)

  - `allowedUserTypes` (array)
    Example: ["Aprovador"]

  - `statusList` (array)
    Example: ["Em análise"]

  - `deadlineFormat` (string,null)
    Example: "days"

  - `deadlineValue` (number,null)
    Example: 5

  - `createdAt` (string)
    Example: "2026-01-15T10:30:00.000Z"

  - `deletedAt` (string,null)
    Example: "2026-02-01T00:00:00.000Z"

  - `deleted` (boolean)

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad Request"

  - `message` (string)
    Example: "O campo form é obrigatório"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "Unauthorized"

  - `message` (string)
    Example: "API Key is required"

## Response 500 fields (application/json):

  - `error` (string)
    Example: "Internal Server Error"

  - `message` (string)
    Example: "Erro inesperado ao criar o despacho"