---
title: "Screen Task"
method: POST
path: "/v1/internal/twins/screen"
tags: ["twins"]
---

# Screen Task

`POST /v1/internal/twins/screen`

## Request

- Base URL: `https://api.getbluejay.ai`
- URL: `https://api.getbluejay.ai/v1/internal/twins/screen`
- Auth: API key in header `X-API-Key`

## Headers

- `x-internal-token` string, nullable
- `X-API-Key` string, required

## Request body

- ScreenRequest
  - `task` string, required
  - `phone` string, nullable
  - `name` string
  - `account_name` string, nullable
  - `mode` 'phone' | 'practice', required

## Response `200`

Successful Response

- ScreenResult
  - `allowed` boolean, required
  - `stage` 'number' | 'moderation' | 'policy' | 'error', required
  - `category` string, nullable, required
  - `reason` string, required
  - `message` string, required
  - `model` string, nullable, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `6e0632573af9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/internal/twins/screen/post.md)

---

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