---
title: "Create Framework Order"
method: POST
path: "/v2/framework/buy"
tags: ["Framework"]
---

# Create Framework Order

`POST /v2/framework/buy`

## Query parameters

- `repurchase_reason` 'refresh' | 'reinstate', nullable

## Request body

- BodyCreateFrameworkOrderV2FrameworkBuyPost
  - `order` FrameworkOrderCreate
    - `frameworks` FrameworkRequest[], required
      - `entities` union, required
        - FrameworkEntityRequest[]
          - `carc_id` integer, required
          - `representation` string, required
          - `entity_name` string, nullable
        - WildCardEntityRequest
          - `carc_name` string
          - `representation` string, required
      - `insight` FrameworkInsightRequest, required
        - `insight_id` integer, required
        - `insight_name` string, nullable
      - `filters` object, required
      - `aggregate` 'sum' | 'mean' | 'count_distinct', nullable
      - `events` FrameworkEventRequest[], nullable
        - `event_id` string, nullable
        - `representation` string, required
        - `event_name` string, nullable
        - `event_category_id` union
          - integer
          - string
  - `framework_id` union
    - string, uuid
    - string[]
  - `source` 'tribes' | 'riastrad' | 'prisms', nullable
  - `config` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `404` — Not Found
- `422` — Validation Error

## Changes

- **2026-07-26** `6ba1ca74e6c7` — 2 info
  - added the new optional request property `order/anyOf[subschema #1: FrameworkOrderCreate]/frameworks/items/events`
  - added the new `prisms` enum value to the request property `source/anyOf[subschema #1]/`

[Change history](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/changes/v2/framework/buy/post.md)

---

[API](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation.md) · [All operations](https://skmtc.dev/carbonarc/apis/carbon-arc-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-api-documentation/revisions/726b1a8471b4/schema)