curl -s -X POST \
  "https://engine.example.com/v1/distributions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: create-distribution-FUND" \
  -H "Content-Type: application/json" \
  -d '{
    "instrumentId": "FUND",
    "period": "2026-10"
  }'

// A client from OpenAPI Generator: see Build a client.
import {
  Configuration,
  DistributionBodyFromJSON,
  DistributionsApi,
  ProblemFromJSON,
  ResponseError,
} from "./nodeasset-client";

const api = new DistributionsApi(new Configuration({
  basePath: "https://engine.example.com",
  accessToken: process.env.TOKEN,
}));

try {
  const answer = await api.createDistribution({
    // Your id for this action: a retry is the same write.
    idempotencyKey: "create-distribution-FUND",
    distributionBody: DistributionBodyFromJSON({
      instrumentId: "FUND",
      period: "2026-10",
    }),
  });
  if (answer.state === "awaiting") {
    // Awaiting approval: it runs once approved.
    console.log("Awaiting approval:", answer.actionKey);
  } else {
    // Follow the operation until it succeeds or fails.
    console.log("Operation:", answer.operationId, answer.state);
  }
} catch (e) {
  if (!(e instanceof ResponseError)) throw e;
  // A refusal is a problem; its type ends in the slug.
  const problem = ProblemFromJSON(await e.response.json());
  const slug = problem.type.split(":").pop();
  console.error(e.response.status, slug, problem.detail);
}

# A client from OpenAPI Generator: see Build a client.
import os
import sys

import nodeasset_client

config = nodeasset_client.Configuration(
    host="https://engine.example.com",
    access_token=os.environ["TOKEN"],
)
with nodeasset_client.ApiClient(config) as client:
    api = nodeasset_client.DistributionsApi(client)
    try:
        answer = api.create_distribution(
            # Your id for this action: a retry is the same write.
            idempotency_key="create-distribution-FUND",
            distribution_body=nodeasset_client.DistributionBody.model_validate({
                "instrumentId": "FUND",
                "period": "2026-10",
            }),
        )
        if answer.state == "awaiting":
            # Awaiting approval: it runs once approved.
            print("Awaiting approval:", answer.action_key)
        else:
            # Follow the operation until it succeeds or fails.
            print("Operation:", answer.operation_id, answer.state)
    except nodeasset_client.ApiException as e:
        # A refusal is a problem; its type ends in the slug.
        problem = nodeasset_client.Problem.from_json(e.body)
        slug = problem.type.rsplit(":", 1)[-1]
        print(e.status, slug, problem.detail, file=sys.stderr)

// A client from OpenAPI Generator: see Build a client.
import nodeasset.client.ApiClient;
import nodeasset.client.ApiException;
import nodeasset.client.api.DistributionsApi;
import nodeasset.client.model.DistributionBody;
import nodeasset.client.model.Problem;
import nodeasset.client.model.WriteAnswer;

public class CreateDistribution {
  public static void main(String[] args) throws Exception {
    ApiClient client = new ApiClient();
    client.updateBaseUri("https://engine.example.com");
    client.setRequestInterceptor(builder ->
        builder.header("Authorization", "Bearer " + System.getenv("TOKEN")));
    DistributionsApi api = new DistributionsApi(client);

    try {
      var request = DistributionsApi.APICreateDistributionRequest.newBuilder()
          // Your id for this action: a retry is the same write.
          .idempotencyKey("create-distribution-FUND")
          .distributionBody(client.getObjectMapper().readValue("""
              {
                "instrumentId": "FUND",
                "period": "2026-10"
              }
              """, DistributionBody.class))
          .build();
      WriteAnswer answer = api.createDistribution(request);
      if (answer.getState() == WriteAnswer.StateEnum.AWAITING) {
        // Awaiting approval: it runs once approved.
        System.out.println("Awaiting approval: " + answer.getActionKey());
      } else {
        // Follow the operation until it succeeds or fails.
        System.out.println("Operation: " + answer.getOperationId() + " " + answer.getState());
      }
    } catch (ApiException e) {
      // A refusal is a problem; its type ends in the slug.
      Problem problem = client.getObjectMapper()
          .readValue(e.getResponseBody(), Problem.class);
      String type = problem.getType();
      String slug = type.substring(type.lastIndexOf(':') + 1);
      System.err.println(e.getCode() + " " + slug + " " + problem.getDetail());
    }
  }
}