---
title: "Start an authentication configuration check"
method: POST
path: "/authentications"
tags: ["Profiles"]
---

# Start an authentication configuration check

`POST /authentications`

## Request

- Base URL: `https://public.escape.tech/v3`
- URL: `https://public.escape.tech/v3/authentications`
- Auth: API key in header `X-ESCAPE-API-KEY`

Validates authentication credentials without running a full scan. Provide `authentication` directly, or pass a `profileId` to reuse its saved authentication (optionally overriding it). Poll `GET /authentications/{id}` until `status` is FINISHED, FAILED, or CANCELED.

## Request body

- object
  - `profileId` string, uuid: Profile whose saved configuration is used as the baseline. When omitted, `authentication` must be provided.
  - `authentication` object: Authentication object to validate. When `profileId` is also set, this replaces the profile saved authentication.
  - `proxyId` string, uuid, nullable: Force a specific Escape or private location (proxy) for this check
  - `defaultProxyType` 'ESCAPE' | 'PRIVATE': When `proxyId` is omitted, restrict to Escape-managed locations or private locations

## Response `200`

OK

- object
  - `id` string, uuid, required: Identifier for this check; use it when polling for status
  - `status` 'CANCELED' | 'FAILED' | 'FINISHED' | 'RUNNING' | 'STARTING', required: Initial lifecycle state (typically STARTING right after creation)

## Other responses

- `400`: Bad Request

---

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