---
title: "Vincular um formulário avulso"
method: POST
path: "/api/management/projects/{project}/loose-forms"
tags: ["projects", "Formulários avulsos"]
---

# Vincular um formulário avulso

`POST /api/management/projects/{project}/loose-forms`

Anexa um formulário existente ao projeto como formulário avulso, deixando-o disponível para resposta independentemente da etapa. O mesmo formulário pode ser anexado mais de uma vez, gerando vínculos distintos.

## Request body

- object — Formulário a vincular.
  - `id` integer, required — ID do formulário a anexar ao projeto.

## Response `200`

Sucesso

- object — Vínculo criado.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `loose_form` object, required — Formulário avulso vinculado ao projeto.
    - `id` integer — ID do vínculo entre o projeto e o formulário.
    - `project_id` string, uuid — Projeto dono do vínculo.
    - `form_id` integer — Formulário vinculado.
    - `frame_id` string, uuid — ID (UUID) da conta dona do vínculo.
    - `created_at` string, date-time — Data do vínculo.
    - `updated_at` string, date-time — Data da última alteração.
    - `form` object — Formulário.
      - `id` integer — ID do formulário.
      - `title` string — Nome do formulário.
      - `frame_id` string, uuid — ID (UUID) da conta dona do formulário.
      - `created_at` string, date-time — Data de criação.
      - `updated_at` string, date-time — Data da última alteração.
      - `deleted_at` string, date-time, nullable — Data em que o formulário foi removido.

## Other responses

- `404` — Formulário não encontrado

## Changes

- **2026-08-24** `3c590152d5b5` — 4 breaking, 5 info
  - the request property `id` became not nullable
  - the request property `id` became required
  - the `id` request property type changed from no type to `integer`
  - the `loose_form/form/deleted_at` response's property type changed from no type to `string`, and format from no format to `date-time` for status `200`
  - …5 more
- **2026-08-19** `3d619d9db20d` — 5 info
  - api tag `Formulários avulsos` added
  - api tag `loose-forms` removed
  - api tag `{id}` removed
  - added the media type `application/json` for the response with the status `200`
  - …1 more
- **2026-08-19** `d270bef5be29` — 1 info
  - added optional request body

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/:project/loose-forms/post.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)