---
title: "Create project assets"
method: POST
path: "/project_assets"
tags: ["project_assets"]
---

# Create project assets

`POST /project_assets`

## Request

- Base URL: `https://app.torgix.ai/v1`
- URL: `https://app.torgix.ai/v1/project_assets`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.torgix.ai/oauth/authorize`, token URL `https://app.torgix.ai/oauth/token`, scopes: `write`)

Creates one record. `company_id` and internal columns are set by Torgix and cannot be supplied; for asset-scoped resources `asset_id` is required and verified to belong to your account. Send `Idempotency-Key` to make retries safe.

## Headers

- `Idempotency-Key` string

## Request body

- object: Writable fields for the record.

## Response `201`

Created.

- object
  - `data` object
  - `request_id` string

## Other responses

- `400`: Malformed request: bad JSON, empty body, bad batch, bad id, or an invalid metric or group_by.
- `401`: Missing or invalid credentials.
- `403`: API access not enabled for the account, missing scope, or IP not allowlisted.
- `409`: A request with this Idempotency-Key is still being processed.
- `422`: The write was rejected (e.g. a required field is missing); `field` names the column.
- `429`: Per-second rate limit exceeded.

---

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