---
title: "Creates a record"
method: POST
path: "/records/{base_id}"
tags: ["record"]
---

# Creates a record

`POST /records/{base_id}`

Creates a single record, including document and/or data.

### To create a record __with__ a file (document)

_Since multipart is required to pass a file, json data must be passed as a part named "body"_

### To create a record __without__ file

_Since no file is passed, data can be passed as plain body_

### metadata / status-bits setting

see "PATCH" method for examples, apply only relevant "set" operation on just created record with empty data.

## Path parameters

- `base_id` ID, required — unresolved $ref

## Request body

- RecordPatch — unresolved $ref

## Response `200`

ok

- ApiResponseRecordReference — unresolved $ref

## Other responses

- `default` — unresolved $ref

---

[API](https://skmtc.dev/alchemy-fr/apis/phraseanet-api.md) · [All operations](https://skmtc.dev/alchemy-fr/apis/phraseanet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alchemy-fr/phraseanet-api/revisions/ccf1f8e89dfd/schema)