---
title: "Authenticate"
method: POST
path: "/v2/auth/authenticate"
tags: ["Auth Service (v2)"]
---

# Authenticate

`POST /v2/auth/authenticate`

Get OAuth token or start authentication flow if needed.

## Request body

- AuthAuthenticateRequest — Auth authenticate request.
  - `user_id` string, nullable
  - `ls_user_id` string, nullable
  - `agent_id` string, nullable
  - `provider` string, required
  - `scopes` string[], required
  - `use_agent_builder_public_oauth` boolean
  - `force_new` boolean
  - `token_id` string, uuid, nullable
  - `redirect_uri` string, nullable
  - `is_default` boolean
  - `check_only` boolean

## Response `200`

Successful Response

- AuthAuthenticateResponse — Auth authenticate response.
  - `status` 'completed' | 'pending' | 'connection_required' | 'token_expired', required — Valid authentication status values.
  - `url` string, nullable
  - `auth_id` string, nullable
  - `token` string, nullable
  - `user_id` string, nullable
  - `metadata` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith-deployment-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith-deployment-control-plane-api/versions/a0cd098699b4/schema)