---
title: "loginRequest"
method: POST
path: "/session"
tags: ["login"]
---

# loginRequest

`POST /session`

Authenticate a login with user credentials

## Request body

- Authenticate
  - `username` string
  - `password` string

## Response `200`

successful operation

- AuthenticationResponse
  - `status` 'OK' | 'ERROR' | 'BAD_REQUEST' | 'CREATED' | 'NO_CONTENT' | 'DELETED' | 'CANCELLED' | 'CLOSED' | 'REMOVED' | 'NOT_FOUND' | 'AUTHENTICATION_FAILED' | 'AUTHENTICATION_OK' | 'INVALID_SESSION_GUID' | 'UNAUTHORIZED' | 'FORBIDDEN' | 'RECEIVED' | 'ACCEPTED' | 'ENQUEUED' | 'INVALID_PARAMETERS' | 'FIELD_VALIDATION_ERROR' | 'ILLEGAL_STATE' | 'NOT_ENOUGH_DATA' | 'VALIDATION_ERROR' | 'IMPORTED' | 'UPDATED' | 'IGNORED' | 'SERVICE_STARTED' | 'SERVICE_CANCELLED' | 'SERVICE_SUBMITTED'
  - `code` integer
  - `sessionGuid` string
  - `user` UserBean
    - `username` string
    - `name` string
    - `canOpenCase` boolean
    - `canEditCase` boolean
    - `canViewCase` boolean
    - `password` string
    - `roles` RoleBean[]
      - `id` string
      - `name` string
      - `application` ApplicationBean
        - `id` string
        - `name` string
        - `description` string
        - `roles` RoleBean[]
        - `functionalities` FunctionalityBean[]
          - `id` string
          - `description` string
          - `application` ApplicationBean — recursive
        - `users` UserBean[]
      - `functionalities` FunctionalityBean[]
        - `id` string
        - `description` string
        - `application` ApplicationBean
          - `id` string
          - `name` string
          - `description` string
          - `roles` RoleBean[]
          - `functionalities` FunctionalityBean[]
          - `users` UserBean[]
      - `users` UserBean[]
  - `token` string
  - `expirationTime` integer
  - `permissions` string[]

## Other responses

- `201` — Authentication ok
- `400` — Parameters validation error
- `403` — Access denied
- `500` — System error

---

[API](https://skmtc.net/griaule/apis/gbds-api.md) · [All operations](https://skmtc.net/griaule/apis/gbds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griaule/gbds-api/versions/fa80f482ec5e/schema)