---
title: "Makes a decision"
method: POST
path: "/owner/{ownerID}/context/{context}/decision"
tags: ["Policy Management"]
---

# Makes a decision

`POST /owner/{ownerID}/context/{context}/decision`

## Request

- Base URL: `https://circleci.com/api/v2`
- URL: `https://circleci.com/api/v2/owner/{ownerID}/context/{context}/decision`
- Auth: one of:
  - API key in header `Circle-Token`
  - HTTP bearer
  - HTTP basic
  - API key in query parameter `circle-token`

This endpoint will evaluate input data (config+metadata) against owner's stored policies and return a decision.

## Path parameters

- `ownerID` string, required
- `context` string, required

## Request body

- object
  - `input` string, required
  - `metadata` object

## Response `200`

Decision rendered by applying the policy against the provided data. Response will be modeled by the data and rego processed.

- Decision
  - `enabled_rules` string[]
  - `hard_failures` Violation[]
    - `reason` string, required
    - `rule` string, required
  - `reason` string
  - `soft_failures` Violation[]
    - `reason` string, required
    - `rule` string, required
  - `status` string, required

## Other responses

- `400`: The request is malformed
- `401`: The request is unauthorized
- `500`: Something unexpected happened on the server.

---

[API](https://skmtc.dev/circleci/apis/circleci-api.md) - [All operations](https://skmtc.dev/circleci/apis/circleci-api/llms.txt) - [OpenAPI document](https://skmtc.dev/circleci/apis/circleci-api/revisions/b9c0e0c24058?raw)
