---
title: "Create a new file"
method: POST
path: "/projects/{id}/files"
---

# Create a new file

`POST /projects/{id}/files`

## Path parameters

- `id` string, required

## Request body

- object
  - `path` string, required
  - `content` string, required

## Response `201`

File created successfully

- File
  - `path` string, required
  - `lines` Line[], required
    - `number` integer
    - `content` string
  - `diagnostics` Diagnostic[]
    - `range` Range, required
      - `start` Position, required
        - `line` integer, required
        - `character` integer, required
      - `end` Position, required
        - `line` integer, required
        - `character` integer, required
    - `severity` 1 | 2 | 3 | 4 — 1: Error, 2: Warning, 3: Information, 4: Hint
    - `code` union
      - string
      - integer
    - `codeDescription` CodeDescription
      - `href` string, uri, required
    - `source` string
    - `message` string, required
    - `tags` integer[]
    - `relatedInformation` DiagnosticRelatedInformation[]
      - `location` Location, required
        - `uri` string, uri, required
        - `range` Range, required
          - `start` Position, required
            - `line` integer, required
            - `character` integer, required
          - `end` Position, required
            - `line` integer, required
            - `character` integer, required
      - `message` string, required
    - `data` object — Additional structured data

## Other responses

- `400` — Invalid request
- `404` — Project not found
- `409` — File already exists
- `500` — Internal server error

---

[API](https://skmtc.dev/hide-org/apis/hide-api.md) · [All operations](https://skmtc.dev/hide-org/apis/hide-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hide-org/hide-api/revisions/615b2b2a65a4/schema)