Create Project

curl -X POST https://api-gateway.merge.dev/v1/projects \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "support-bot",
  "budget_config": {
    "amount": 500,
    "enforcement_mode": "hard_limit",
    "period": "monthly",
    "alert_thresholds": [
      50,
      80,
      90
    ],
    "notification_emails": [
      "finance@acme.com"
    ],
    "notify_org_admins": true
  },
  "description": "Customer support assistant.",
  "routing_policy": {
    "strategy": "PRIORITY",
    "description": "Claude first, GPT-5.5 as the fallback.",
    "name": "support-bot routing policy",
    "priority_order": [
      {
        "model": "anthropic/claude-sonnet-4-6",
        "priority": 1
      },
      {
        "model": "openai/gpt-5.5",
        "priority": 2
      }
    ]
  },
  "uses_organization_default_routing": false
}'

{
  "budget_config": {
    "amount": 500,
    "enforcement_mode": "hard_limit",
    "period": "monthly",
    "alert_thresholds": [
      50,
      80,
      90
    ],
    "notification_emails": [
      "finance@acme.com"
    ],
    "notify_org_admins": true
  },
  "created_at": "2026-06-02T17:04:00Z",
  "description": "Customer support assistant.",
  "id": "8b6f2d4a-1c3e-4b5a-9f7d-2e0c6a8b4d91",
  "is_active": true,
  "name": "support-bot",
  "organization_id": "3f2b8c1e-6a4d-4e7f-9b21-5c8d0e7a4f13",
  "routing_policy": {
    "allowed_models": null,
    "allowed_providers": null,
    "axis": null,
    "created_at": "2026-06-02T17:04:00Z",
    "description": "Claude first, GPT-5.5 as the fallback.",
    "id": "c4e1a7b2-9d3f-4a6e-8b5c-1f2d3e4a5b6c",
    "model": null,
    "modified_at": "2026-06-02T17:04:00Z",
    "name": "support-bot routing policy",
    "priority_order": [
      {
        "model": "anthropic/claude-sonnet-4-6",
        "priority": 1
      },
      {
        "model": "openai/gpt-5.5",
        "priority": 2
      }
    ],
    "slug": null,
    "strategy": "PRIORITY"
  },
  "slug": "support-bot",
  "updated_at": "2026-09-14T09:30:00Z",
  "uses_organization_default_routing": false
}

Create a project, optionally with its own routing policy and a spending budget. Without a routing policy, the project routes with the organization's default.

Authentication

AuthorizationBearer

A management key (mgmt_...), sent as Authorization: Bearer <key>. Reading /v1/routing-policies also accepts the organization’s gateway API keys; writing there needs a management key.

Request

This endpoint expects an object.

namestringRequired<=255 characters

The project's name.

budget_configobject or nullOptional

A spending budget for the project.

descriptionstring or nullOptional

What the project is for.

routing_policyobject or nullOptional

The project’s own routing policy. Send it with uses_organization_default_routing false.

uses_organization_default_routingbooleanOptionalDefaults to true

true routes the project with the organization’s default policy. false needs routing_policy, which becomes the project’s own policy.

Response

The created project

budget_configobject or null

The project’s spending budget; null when it has none.

created_atdatetimeRead-only

When the project was created.

descriptionstring or null

What the project is for.

idstringRead-onlyformat: "uuid"

The project's id.

is_activeboolean

false while the project's prompt injection, DLP and controls overrides are switched off.

namestring

The project's name.

organization_idstringRead-onlyformat: "uuid"

The organization the project belongs to.

routing_policyobject or null

The project’s own routing policy; null when it uses the organization default.

slugstringRead-only

Derived from the name at creation and unique in the organization. It doesn't change when the project is renamed.

updated_atdatetimeRead-only

When the project last changed.

uses_organization_default_routingboolean

true when the project routes with the organization's default policy, having no policy of its own.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

502

Bad Gateway Error