---
title: "Create sign-in request"
method: POST
path: "/auth/signin-requests"
tags: ["auth"]
---

# Create sign-in request

`POST /auth/signin-requests`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/auth/signin-requests`
- Auth: none declared

Create an agent sign-in request.

## Request body

- object
  - `codeHash` string, required
  - `sessionTokenHash` string, required
  - `agentName` string, required
  - `agentKind` string, required: Agent kind, normalized to snake_case.
  - `intent` 'join_existing' | 'create_workspace', required: Whether to join an existing workspace or create a new one.
  - `proposedOrganizationName` string: Required when intent is create_workspace.
  - `requestedOrganizationSelector` string
  - `userAgent` string

## Response `200`

Successful response

- object
  - `status` 'pending', required
  - `expiresAt` number, required: Epoch ms when the sign-in code expires.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

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