---
title: "Create AuthSession - Start"
method: POST
path: "/{workspaceId}/projects/{projectName}/auth-sessions/create"
tags: ["projects.authSessions.create"]
---

# Create AuthSession - Start

`POST /{workspaceId}/projects/{projectName}/auth-sessions/create`

## Request

- Base URL: `https://app.intuned.io/api/v1/workspace`
- URL: `https://app.intuned.io/api/v1/workspace/{workspaceId}/projects/{projectName}/auth-sessions/create`
- Auth: API key in header `x-api-key`

Start creating an AuthSession.

## Path parameters

- `workspaceId` string, uuid, required
- `projectName` string, required

## Request body

- object
  - `id` string: The unique identifier for the authentication session
  - `parameters` object, required: The parameters to be passed to the API.
  - `proxy` string, uri, nullable: Proxy configuration for the job
  - `createAttempts` integer: Number of attempts to create a new AuthSession if the current one is invalid or expired.
  - `checkAttempts` integer: Number of attempts to check the validity of the AuthSession before recreating it.
  - `saveTrace` boolean

## Response `201`

Create AuthSession operation started

- object
  - `status` 'started', required
  - `operationId` string, required

---

[API](https://skmtc.dev/intunedhq/apis/intuned-client.md) - [All operations](https://skmtc.dev/intunedhq/apis/intuned-client/llms.txt) - [OpenAPI document](https://skmtc.dev/intunedhq/apis/intuned-client/revisions/9f87fec44145?raw)