AMCS Group

AMCS Group Auth API

The Auth API from AMCS Group — 2 operation(s) for auth.

Documentation GitHub OpenAPI

Operations 2

POST /authTokens Auth by Private Key

POST /visionai/api/authTokens Auth by Private Key

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/amcs-group/refs/heads/main/openapi/amcs-group-auth-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/amcs-group-auth-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Core AccessGroup Auth API
  version: core
servers:
- url: https://rstapi-sbx-svc-core.amcsplatform.com/erp/api/integrator/erp
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Auth
paths:
  /authTokens:
    post:
      tags:
      - Auth
      summary: Auth by Private Key
      description: "This endpoint is used for authentication and authorisation of a calling application by supplying the Tenant Private Key in the privateKey property. When successful, Platform.PAY.SessionToken is added to the cookie. \n\n## Request\n\n| **Property** | **Description** |\n| --- | --- |\n| PrivateKey | This is a Personal Access Token (PAT), generated during Tenant Registration. |\n\n## Response\nAdditional fields from the response, other from the one below, can be disregarded.\n\n| **Property** | **Description** |\n| --- | --- |\n| AuthResult | The authentication and authorization result. Returns \"ok\" if successful otherwise returns \"invalidCredentials\"."
      security: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AMCSPayUserCredentials'
      responses:
        '200':
          description: Ok
          headers:
            Set-Cookie:
              schema:
                type: string
                example: Platform.PAY.SessionToken=abcde12345; Path=/; HttpOnly
                description: Subsequent calls to the REST API will use this cookie to authenticate and authorize requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AMCSPayLoginResponse'
  /visionai/api/authTokens:
    post:
      tags:
      - Auth
      summary: Auth by Private Key
      description: "This endpoint is used for authentication and authorisation of a calling application by supplying the Tenant Private Key in the privateKey property. When successful, Platform.VisionAI.SessionToken is added to the cookie. \n\n## Request\n\n| **Property** | **Description** |\n| --- | --- |\n| PrivateKey | This is a Personal Access Token (PAT), generated during Tenant Registration. |\n\n## Response\nAdditional fields from the response, other from the one below, can be disregarded.\n\n| **Property** | **Description** |\n| --- | --- |\n| AuthResult | The authentication and authorization result. Returns \"ok\" if successful otherwise returns \"invalidCredentials\"."
      security: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AMCS.IoT.UserCredentials'
      responses:
        '200':
          description: Ok
          headers:
            Set-Cookie:
              schema:
                type: string
                example: Platform.VisionAI.SessionToken=abcde12345; Path=/; HttpOnly
                description: Subsequent calls to the REST API will use this cookie to authenticate and authorize requests.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AMCS.IoT.LoginResponse'
components:
  schemas:
    AMCSPayLoginResponse:
      type: object
      properties:
        authResult:
          type: string
          example: ok
        userName:
          type:
          - string
          - 'null'
          example: ADMIN01
        userIdentity:
          type:
          - string
          - 'null'
          example: ADMIN
        sysUserId:
          type:
          - integer
          - 'null'
          format: int32
          example: 3
        userGuid:
          type:
          - string
          - 'null'
          format: uuid
          example: 607e37cd-4f51-4148-af23-4459b74fc3b2
        companyOutletId:
          type:
          - integer
          - 'null'
          format: int32
          example: 10
        companyOutletGuid:
          type:
          - string
          - 'null'
          format: uuid
          example: 5feaaae5-7733-4e45-ac39-87d46cf138e0
        stayLoggedIn:
          type:
          - boolean
          - 'null'
          example: false
    AMCS.IoT.UserCredentials:
      type: object
      required:
      - privateKey
      properties:
        privateKey:
          type: string
          example: 1zEFtwJQE0cmKUE3AvnzBbm5
      additionalProperties: false
    AMCS.IoT.LoginResponse:
      type: object
      properties:
        authResult:
          type: string
          example: ok
        userName:
          type:
          - string
          - 'null'
          example: ADMIN01
        userIdentity:
          type:
          - string
          - 'null'
          example: ADMIN
        sysUserId:
          type:
          - integer
          - 'null'
          format: int32
          example: 3
        userGuid:
          type:
          - string
          - 'null'
          format: uuid
          example: 607e37cd-4f51-4148-af23-4459b74fc3b2
        companyOutletId:
          type:
          - integer
          - 'null'
          format: int32
          example: 10
        companyOutletGuid:
          type:
          - string
          - 'null'
          format: uuid
          example: 5feaaae5-7733-4e45-ac39-87d46cf138e0
        stayLoggedIn:
          type:
          - boolean
          - 'null'
          example: false
    AMCSPayUserCredentials:
      type: object
      required:
      - privateKey
      properties:
        privateKey:
          type: string
          example: 1zEFtwJQE0cmKUE3AvnzBbm5
      additionalProperties: false