# Create a file certification

Creates a new certification from uploaded files (upload session)

Endpoint: POST /v1/file-certifications
Version: 1.5.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    http bearer API Key

## Request body:

  - `application/json` (unknown)
    Request payload for creating a file certification

## Request fields (application/json):

  - `title` (string, required)
    Title of the certification

  - `generate_pdf_report` (boolean)
    Whether to generate a PDF report (defaults to true)

  - `webhook_url` (string)
    Optional webhook URL for completion notification. Callbacks are signed per the Standard Webhooks specification. The payload uses a standard envelope with type, timestamp and data fields.

  - `metadata` (object)
    Optional metadata key-value pairs

  - `upload_session_token` (string, required)
    Token received from file-certifications-attachments step

## Request examples:

  - `Create file certification (placeholder)` (unknown)

## Response 201:

  - `201` (unknown)
    Created file certification

## Response 201 fields (application/json):

  - `report_id` (string, required)
    Unique report identifier

  - `status` (string, required)
    Certification status

  - `credits_amount` (number, required)
    Credits consumed

  - `title` (string, required)
    Title of the certification

  - `created_at` (string, required)
    Creation timestamp

## Response 400:

  - `400` (unknown)
    Validation error

## Response 400 fields (application/problem+json):

  - `type` (string)
    A URI reference that identifies the problem type.
    Example: https://api.truescreen.io/errors/validation-error

  - `title` (string, required)
    Short, human-readable summary of the problem.
    Example: Validation failed

  - `status` (integer)
    HTTP status code.
    Example: 400

  - `detail` (string)
    Human-readable explanation specific to this occurrence.
    Example: One or more fields have invalid values

  - `code` (string, required)
    Unique code to identify the error.
    Example: TS-000

## Response 201 examples:

  - `Created file certification (placeholder)` (unknown)

## Response 400 examples:

  - `Malformed payload or missing auth` (unknown)

  - `Missing required field` (unknown)

  - `Attachment already linked to template` (unknown)

  - `Insufficient credits available` (unknown)

  - `No certification attachments found` (unknown)

  - `Certification already created for upload session token` (unknown)

  - `Not all files have been uploaded` (unknown)