---
title: "POST /requests"
method: POST
path: "/requests"
tags: ["Assets"]
---

# POST /requests

`POST /requests`

Requests endpoints allows the creation of different kind of requests to handle the life cycle
of Assets.

## Request body

- union
  - DpAssetPurchaseRequest
    - `type` 'purchase'
    - `note` string
    - `reason` string
    - `status` 'draft' | 'tiers_setup' | 'pending' | 'inquiring' | 'approved' | 'failed'
    - `asset` object
      - `external_id` string
      - `external_uid` string
      - `connection` object
        - `id` string
      - `items` object[]
        - `id` string
        - `quantity` number
      - `params` object[]
        - `id` string
        - `title` string
        - `description` string
        - `value` string
        - `value_error` string
        - `structured_error` object
          - `message` object
            - `id` string
            - `external_id` string
            - `value` string
          - `context` object
        - `type` 'text' | 'dropdown' | 'password' | 'email' | 'checkbox' | 'subdomain' | 'domain' | 'phone' | 'url' | 'choice'
        - `scope` 'asset' | 'tier1' | 'tier2'
        - `value_choices` object[]
          - `label` string
          - `value` string
        - `phase` 'fulfillment' | 'ordering'
        - `constraints` object
          - `required` boolean
          - `hidden` boolean
          - `readonly` boolean
          - `unique` boolean
          - `reconciliation` boolean
          - `shared` 'view' | 'edit'
      - `tiers` object
        - `customer` object
          - `external_id` string
          - `external_uid` string
          - `name` string
          - `tax_id` string
          - `contact_info` object
            - `address_line1` string, required
            - `address_line2` string
            - `city` string, required
            - `state` string
            - `postal_code` string, required
            - `country` string, required
            - `contact` object, required
              - …
        - `tier1` object
          - `external_id` string
          - `external_uid` string
          - `name` string
          - `tax_id` string
          - `contact_info` object
            - `address_line1` string, required
            - `address_line2` string
            - `city` string, required
            - `state` string
            - `postal_code` string, required
            - `country` string, required
            - `contact` object, required
              - …
        - `tier2` object
          - `external_id` string
          - `external_uid` string
          - `name` string
          - `tax_id` string
          - `contact_info` object
            - `address_line1` string, required
            - `address_line2` string
            - `city` string, required
            - `state` string
            - `postal_code` string, required
            - `country` string, required
            - `contact` object, required
              - …
  - DpAssetChangeRequest
    - `type` 'change'
    - `asset` object
      - `id` string
      - `items` object[]
        - `id` string
        - `quantity` number
  - DpAssetSuspendResumeCancelRequest
    - `type` 'suspend' | 'resume' | 'cancel'
    - `asset` object
      - `id` string

## Response `201`

- unknown

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)