> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Alpha.Decisions

> Alpha feature endpoints for Decisions requests

## Overview

Alpha feature endpoints for Decisions requests

### Available Operations

* [create](#create) - Submit a Decisions request

## create

Asks a Decisions model typed questions (`noul`, `choice`, `score`, `box`) about the content in `state` and returns one typed answer per question with its probabilities. Images, audio and video go in `state` as `image_url`, `input_audio` and `video_url` parts; PNG and JPEG images can instead go once in `assets` and be referenced by key. Which question types, media parts and asset references an endpoint accepts depends on the provider; a request an endpoint cannot serve fails with `400` before anything is sent upstream. See the [Multimodal Decisions guide](https://openrouter.ai/docs/client-sdks/typescript/docs/guides/community/multimodal-decisions) for the per-provider table. Typed fields (text, numbers, dates, lists, estimates, forecasts) come from [`POST /api/alpha/extractions`](https://openrouter.ai/docs/client-sdks/typescript/docs/guides/community/extractions), which takes the same envelope with `fields` in place of `questions` (text `state` only; images and PDFs go in `assets`). Alpha: the shape may change.

### Example Usage

```typescript theme={null}
import { OpenRouter } from "@openrouter/sdk";

const openRouter = new OpenRouter({
  httpReferer: "<value>",
  appTitle: "<value>",
  appCategories: "<value>",
  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});

async function run() {
  const result = await openRouter.alpha.decisions.create({
    decisionsRequest: {
      model: "typesafe/jev-1.13",
      questions: {
        "is_bug": {
          criteria: {
            false: "The customer is asking a question or requesting a feature.",
            true: "The customer describes broken or unexpected product behavior.",
          },
          instructions: "Is the customer reporting a software defect?",
          type: "noul",
        },
        "team": {
          criteria: {
            "account": "Login, permissions, or profile issues.",
            "frontend": "Rendering, layout, or browser compatibility issues.",
            "payments": "Checkout, billing, or payment processing issues.",
          },
          instructions: "Which team should own this ticket?",
          type: "choice",
        },
        "urgency": {
          criteria: [
            "Can wait for the next release",
            "Should be fixed this week",
            "Blocking revenue right now",
          ],
          instructions: "How urgent is this ticket?",
          type: "score",
        },
      },
      state: {
        "customer_tier": "enterprise",
        "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers.",
      },
    },
  });

  console.log(result);
}

run();
```

### Standalone function

The standalone function version of this method:

```typescript theme={null}
import { OpenRouterCore } from "@openrouter/sdk/core.js";
import { alphaDecisionsCreate } from "@openrouter/sdk/funcs/alphaDecisionsCreate.js";

// Use `OpenRouterCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const openRouter = new OpenRouterCore({
  httpReferer: "<value>",
  appTitle: "<value>",
  appCategories: "<value>",
  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
});

async function run() {
  const res = await alphaDecisionsCreate(openRouter, {
    decisionsRequest: {
      model: "typesafe/jev-1.13",
      questions: {
        "is_bug": {
          criteria: {
            false: "The customer is asking a question or requesting a feature.",
            true: "The customer describes broken or unexpected product behavior.",
          },
          instructions: "Is the customer reporting a software defect?",
          type: "noul",
        },
        "team": {
          criteria: {
            "account": "Login, permissions, or profile issues.",
            "frontend": "Rendering, layout, or browser compatibility issues.",
            "payments": "Checkout, billing, or payment processing issues.",
          },
          instructions: "Which team should own this ticket?",
          type: "choice",
        },
        "urgency": {
          criteria: [
            "Can wait for the next release",
            "Should be fixed this week",
            "Blocking revenue right now",
          ],
          instructions: "How urgent is this ticket?",
          type: "score",
        },
      },
      state: {
        "customer_tier": "enterprise",
        "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers.",
      },
    },
  });
  if (res.ok) {
    const { value: result } = res;
    console.log(result);
  } else {
    console.log("alphaDecisionsCreate failed:", res.error);
  }
}

run();
```

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `request` | [operations.CreateApiAlphaDecisionsRequest](../../models/operations/createapialphadecisionsrequest.mdx) | ✔️ | The request object to use for the request. |
| `options` | RequestOptions | ➖ | Used to set various options for making HTTP requests. |
| `options.fetchOptions` | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options) | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
| `options.retries` | [RetryConfig](../../lib/utils/retryconfig.mdx) | ➖ | Enables retrying HTTP requests under certain failure conditions. |
| `options.serverURL` | *string* | ➖ | An optional server URL to use. |

### Response

**Promise\<[models.DecisionsResponse](../../models/decisionsresponse.mdx)>**

### Errors

| Error Type | Status Code | Content Type |
| - | - | - |
| errors.BadRequestResponseError | 400 | application/json |
| errors.UnauthorizedResponseError | 401 | application/json |
| errors.PaymentRequiredResponseError | 402 | application/json |
| errors.ForbiddenResponseError | 403 | application/json |
| errors.NotFoundResponseError | 404 | application/json |
| errors.PayloadTooLargeResponseError | 413 | application/json |
| errors.TooManyRequestsResponseError | 429 | application/json |
| errors.InternalServerResponseError | 500 | application/json |
| errors.BadGatewayResponseError | 502 | application/json |
| errors.ServiceUnavailableResponseError | 503 | application/json |
| errors.EdgeNetworkTimeoutResponseError | 524 | application/json |
| errors.ProviderOverloadedResponseError | 529 | application/json |
| errors.OpenRouterDefaultError | 4XX, 5XX | \*/\* |