POST /v1/instances
Tags: instances
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Idempotency-Key | header | string,null | Optional idempotency token; replays return cached response. |
Request body
Required.
JSON
{
"$ref": "#/components/schemas/CreateInstance"
}Responses
201
JSON
{
"$ref": "#/components/schemas/Instance"
}400 — INVALID_REQUEST
409 — CONFLICT — name already exists
429 — QUOTA_EXCEEDED
Code samples
TypeScript
TypeScript
import { firecase } from "@firecase/sdk";
const result = await firecase.post("/instances", { /* body */ });
console.log(result);Python
Python
import firecase
result = firecase.post("/instances", json={})
print(result)curl
Bash
curl -X POST https://api.firecase.ai/v1/instances \
-H "Authorization: Bearer $FIRECASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'