Sesión del Asistente de Atlas para el usuario de la sesión web

curl --request GET \
  --url https://api.ugps.io/api/auth/assistant-session \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/auth/assistant-session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/auth/assistant-session",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/auth/assistant-session"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/auth/assistant-session")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "user": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "firstName": "Ana"
  },
  "client": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d2",
    "name": "Transportes Demo"
  },
  "permissions": [
    "access_tracking",
    "access_trips"
  ],
  "assistantEnabled": true,
  "credits": {
    "unlimited": false,
    "monthly": 500,
    "extra": 0,
    "usedThisMonth": 312,
    "remaining": 188,
    "periodKey": "2026-11"
  }
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Auth - Autenticación

Sesión del Asistente de Atlas para el usuario de la sesión web

Consumido por el servidor del Asistente (@atlas/mcp, POST /assistant/chat), que reenvía el bearer de la sesión web, y por la web para decidir si muestra el botón del Asistente. Solo acepta una sesión web directa: un token OAuth del MCP, un API token (atk_), una sesión de la aplicación móvil o del portal y una impersonación (log-as-user) responden 403.

Comportamiento:

permissions son los permisos de acceso efectivos: los del rol, recortados por las restricciones de la empresa y sin access_admin_panel. Deciden qué herramientas ofrece el Asistente; cada ruta vuelve a exigir el suyo.
403 con código ASSISTANT_DISABLED si la empresa no tiene el Asistente habilitado.

GET

api

auth

assistant-session

Sesión del Asistente de Atlas para el usuario de la sesión web

curl --request GET \
  --url https://api.ugps.io/api/auth/assistant-session \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ugps.io/api/auth/assistant-session', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ugps.io/api/auth/assistant-session",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ugps.io/api/auth/assistant-session"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ugps.io/api/auth/assistant-session")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "user": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d1",
    "firstName": "Ana"
  },
  "client": {
    "id": "65f1a2b3c4d5e6f7a8b9c0d2",
    "name": "Transportes Demo"
  },
  "permissions": [
    "access_tracking",
    "access_trips"
  ],
  "assistantEnabled": true,
  "credits": {
    "unlimited": false,
    "monthly": 500,
    "extra": 0,
    "usedThisMonth": 312,
    "remaining": 188,
    "periodKey": "2026-11"
  }
}

{
  "error": "Token inválido o expirado"
}

{
  "error": "No tiene permisos para realizar esta acción"
}

{
  "error": "Recurso no encontrado"
}

{
  "message": "Error interno del servidor"
}

Authorizations

Authorization

string

header

required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Response

Sesión del Asistente resuelta

user

object

Show child attributes

client

object

Show child attributes

permissions

string[]

Example:

["access_tracking", "access_trips"]

assistantEnabled

boolean

Example:

true

credits

object

Créditos del Asistente de la empresa en el mes de Chile. Un crédito es 0,01 USD de costo real de la API del modelo. remaining puede quedar negativo tras el último turno.

Show child attributes