---
title: "Insert new securities"
method: POST
path: "/security/{type}"
tags: ["security"]
---

# Insert new securities

`POST /security/{type}`

## Request

- Base URL: `https://api.merqube.com`
- URL: `https://api.merqube.com/security/{type}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/merqube/apis/merqube-api/docs/security/:type/post.ts> (a function with typed inputs; its response is checked against the schema)

Insert new securities

## Request body

- NewSecurity
  - `eff_ts` union
    - string, date-time
    - string, date
    - string
  - `name` string, required
  - `namespace` string, required: the calling user must have permission to this namespace to create the security in this namespace
  - `prov_ts` union, required
    - string, date-time
    - string, date
    - string
  - `source` string

## Response `200`

OK

- SecurityCreationResponse
  - `id` string
  - `inserts` integer

## Other responses

- `400`: bad request
- `403`: unauthorized
- `409`: duplicate, e.g., name already exists

---

[API](https://skmtc.dev/merqube/apis/merqube-api.md) - [All operations](https://skmtc.dev/merqube/apis/merqube-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merqube/apis/merqube-api/revisions/20f47ca36587?raw)