> ## Documentation Index
> Fetch the complete documentation index at: https://docs-platform.services-valid.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar clearance

> Cria um novo clearance e retorna seu UUID gerado automaticamente.

## Request Body

<ParamField body="name" type="string" required>
  Nome do clearance. **Exemplo**: `SERPRO ID`
</ParamField>

<ParamField body="slug" type="string">
  Slug do clearance. **Exemplo**: `serpro-id`
</ParamField>

<ParamField body="description" type="string">
  Descrição do clearance. **Exemplo**: `Validação via SERPRO ID`
</ParamField>

## Response

<ResponseField name="message" type="string">
  Feedback. **Exemplo**: `Clearance criado com sucesso.` (Status 200) - `Erro ao
      criar clearance.` (Status 500)
</ResponseField>

<ResponseField name="clearance" type="object">
  Dados do clearance criado.

  <Expandable title="properties">
    <ResponseField name="uuid" type="string">
      UUID do clearance. **Exemplo**: `7604086b-cc97-4a2c-b928-7905fa4d6428`
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome do clearance. **Exemplo**: `SERPRO ID`
    </ResponseField>

    <ResponseField name="slug" type="string">
      Slug do clearance. **Exemplo**: `serpro-id`
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição. **Exemplo**: `Validação via SERPRO ID`
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Data de criação. **Exemplo**: `2023-10-10T14:00:00Z`
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Data de atualização. **Exemplo**: `2023-10-10T14:00:00Z`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Created theme={"theme":"catppuccin-latte"}
  {
    "message": "Clearance criado com sucesso.",
    "clearance": {
      "uuid": "7604086b-cc97-4a2c-b928-7905fa4d6428",
      "name": "SERPRO ID",
      "slug": "serpro-id",
      "description": "Validação via SERPRO ID",
      "created_at": "2023-10-10T14:00:00Z",
      "updated_at": "2023-10-10T14:00:00Z"
    }
  }
  ```

  ```json 500 Erro ao criar clearance theme={"theme":"catppuccin-latte"}
  {
    "message": "Erro ao criar clearance."
  }
  ```
</ResponseExample>