API for Private Tokens

This page describes management of Private tokens via API.

Once you have the short-lived token from logging in, the next step is to create a long-living token (it's called a Private Token). This token is meant for backend server use, allowing you to make API requests without needing to constantly re-authenticate.

What can you do?

• Create new private token

• List your private tokens

• Revoke your private token

Create new private token

Create private token

post

Authorizations

PrivateTokenAuthPasswordAuthcookieAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Body

application/json

namestring · min: 1Required

expiration_timestring · date-timeRequired

Responses

201Success

application/json

idintegerRead-onlyRequired

namestringRequired

expiration_timestring · date-timeRequired

datastringRead-onlyRequired

400Error

application/json

post

/api/v1/auth/private_tokens/

HTTPcURLJavaScriptPython

POST /api/v1/auth/private_tokens/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "name": "text",
  "expiration_time": "2026-03-03T02:38:04.398Z"
}

{
  "id": 1,
  "name": "text",
  "expiration_time": "2026-03-03T02:38:04.398Z",
  "data": "text"
}

---

List your private tokens

Get private tokens list

get

Authorizations

PrivateTokenAuthPasswordAuthcookieAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Query parameters

orderingstringOptional

Which field to use when ordering the results.

qstringOptional

A search term.

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Responses

200Success

application/json

get

/api/v1/auth/private_tokens/

HTTPcURLJavaScriptPython

GET /api/v1/auth/private_tokens/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

{
  "count": 123,
  "next": "http://api.example.org/accounts/?page=4",
  "previous": "http://api.example.org/accounts/?page=2",
  "results": [
    {
      "id": 1,
      "name": "text",
      "expiration_time": "2026-03-03T02:38:04.398Z"
    }
  ]
}

---

Revoke your private token

Revoke private token

delete

Authorizations

PrivateTokenAuthPasswordAuthcookieAuth

AuthorizationstringRequired

Authenticate using SaaS Private token

Path parameters

idintegerRequired

A unique integer value identifying this private token.

Responses

204

No response body

delete

/api/v1/auth/private_tokens/{id}/

HTTPcURLJavaScriptPython

DELETE /api/v1/auth/private_tokens/{id}/ HTTP/1.1
Host: saas.haut.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No response body

No content