---
title: "Evaluate policy for a socket"
method: POST
path: "/socket/{socket_id_or_name}/evaluate"
---

# Evaluate policy for a socket

`POST /socket/{socket_id_or_name}/evaluate`

## Request

- Base URL: `https://api.border0.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.border0.com/socket/{socket_id_or_name}/evaluate`
- Auth: API key in header `Authorization`

## Path parameters

- `socket_id_or_name` string, required

## Request body

- V1EvaluatePolicyRequest
  - `client_ip` string, required
  - `session_key` string, required
  - `user_email` string, required

## Response `200`

OK

- V1EvaluatePolicyResponse
  - `allowed_actions` object
  - `info` object
  - `permissions` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

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