This operation exchanges the user's username and password directly for an access token. 

The client ID and client secret are used for client authentication (basic). Certain endpoints require the access token in the Authorization header to perform admin functions like creating menus. 

If an existing access token is associated with the user, it will be invalidated before a new one is generated.


Authenticate the user and obtain an access token

An alpha-numeric string generated when authenicating a user and required for protected endpoints. 

Expires after ### seconds.


The date and time the resource was created. Timestamp uses ISO 8601 format, Ex: `2025-04-05T14:55:03.824Z` 


Indicates when a token expires and should be refreshed to maintain a user's authentication. Timestamp uses ISO 8601 format, Ex: `2025-04-05T14:55:03.824Z` 


A unique alpha-numeric string generated by the system when creating a resource (e.g., dishes, ingredients, etc). Ids are required for retrieving the properties of a specific resource.


A password must be at least eight characters long and contain at least one uppercase letter, one lowercase letter, one digit, and one special character (@, $, !, %, *, ?, &).

The alpha-numeric refresh token value, used to re-authenticate a user after the authentication token expires.

The type of token used in an `/auth` request.

The date and time the resource was last updated. 

Timestamp uses ISO 8601 format, Ex: `2025-04-05T14:55:03.824Z` 


The user name of the user for login purposes. It cannot contain spaces.

The request body to create a token requires the following properties: `grant_type`, `user_name`, and `password`.


BasicAuth

Resource created successfully. The response body contains the newly created resource.

The response object returned for both `/auth` endpoints.


The server URL used for the point of service API

Codespace URL used by Sarah Holdgrafer for Mastering API Documentation course.

Mint Starter Kit

Welcome to the home of your new documentation

Introduction

Start building awesome documentation in under 5 minutes

Quickstart

Preview changes locally to update your docs

Development

Text, title, and styling in standard markdown

Markdown Syntax

Code Blocks

Add image, video, and other HTML elements

Images and Embeds

Mintlify gives you complete control over the look and feel of your documentation using the docs.json file

Global Settings

The navigation field in docs.json defines the pages that go in the navigation menu

API Documentation

Endpoints

Authenticate the user and obtain an access token

Authorizations

Body

Response