Mitratech

Mitratech Users API

The Users API from Mitratech — 5 operation(s) for users.

GitHub OpenAPI

Operations 8

GET /v1/users/{id} Get by ID #
GET /v1/users/current Current User #
GET /v1/users/Roles User Roles #
GET /v1/users/Departments User Departments #
GET /v1/users All Users #
POST /v1/users Create User #
DELETE /v1/users Delete Users #
PATCH /v1/users Update User #

Documentation

📖
Documentation
https://success.mitratech.com/TAP/TAP_Solutions/APIs_and_Integrations/TAP_API_Documentation
📖
APIReference
https://default.stagingtap.thinksmart.com/default/api/swagger/ui/index
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/authentication/mitratech-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/openapi/mitratech-users-api-openapi.yml

Other Resources

🔗
Console
https://default.stagingtap.thinksmart.com/default/api/swagger/ui/index
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/scopes/mitratech-scopes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/conventions/mitratech-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/errors/mitratech-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/data-model/mitratech-data-model.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/mitratech/refs/heads/main/sandbox/mitratech-sandbox.yml
🔗
Examples
https://github.com/ThinkSmart/API_Examples

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/mitratech-users-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

mitratech-users-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: v1
  title: TAP API Explorer Users API
servers:
- url: https://demo.tap.thinksmart.com/prod/api
tags:
- name: Users
paths:
  /v1/users/{id}:
    get:
      tags:
      - Users
      summary: Get by ID
      description: Returns user info by ID
      operationId: Users_Get
      parameters:
      - name: id
        in: path
        description: User ID
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
            text/json:
              schema:
                $ref: '#/components/schemas/User'
            application/xml:
              schema:
                $ref: '#/components/schemas/User'
            text/xml:
              schema:
                $ref: '#/components/schemas/User'
        '404':
          description: Not Found
  /v1/users/current:
    get:
      tags:
      - Users
      summary: Current User
      description: Returns authenticated user info
      operationId: Users_GetCurrent
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
            text/json:
              schema:
                $ref: '#/components/schemas/User'
            application/xml:
              schema:
                $ref: '#/components/schemas/User'
            text/xml:
              schema:
                $ref: '#/components/schemas/User'
  /v1/users/Roles:
    get:
      tags:
      - Users
      summary: User Roles
      description: Get all existing roles. These role id’s further can be used for creating or updating users.
      operationId: Users_getRoles
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Role'
            text/json:
              schema:
                $ref: '#/components/schemas/Role'
            application/xml:
              schema:
                $ref: '#/components/schemas/Role'
            text/xml:
              schema:
                $ref: '#/components/schemas/Role'
  /v1/users/Departments:
    get:
      tags:
      - Users
      summary: User Departments
      description: Get all existing departments. These department id’s further can be used for creating or updating users.
      operationId: Users_getDepartments
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Departmnt'
            text/json:
              schema:
                $ref: '#/components/schemas/Departmnt'
            application/xml:
              schema:
                $ref: '#/components/schemas/Departmnt'
            text/xml:
              schema:
                $ref: '#/components/schemas/Departmnt'
  /v1/users:
    get:
      tags:
      - Users
      summary: All Users
      description: Returns TAP users info
      operationId: getV1Users
      parameters:
      - name: $top
        in: query
        description: The max number of records
        required: false
        schema:
          type: string
      - name: $skip
        in: query
        description: The number of records to skip
        required: false
        schema:
          type: string
      - name: $filter
        in: query
        description: A function that must evaluate to true for a record to be returned
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Specifies a subset of properties to return
        required: false
        schema:
          type: string
      - name: $orderby
        in: query
        description: Determines what values are used to order a collection of records
        required: false
        schema:
          type: string
      - name: $inlinecount
        in: query
        description: Set <b>'allpages'</b> if you want to have total count value in result
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageResult_AdvancedUserModel'
            text/json:
              schema:
                $ref: '#/components/schemas/PageResult_AdvancedUserModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/PageResult_AdvancedUserModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/PageResult_AdvancedUserModel'
      x-operation-id-source: normalized
      x-operation-id-original: Users_Get
    post:
      tags:
      - Users
      summary: Create User
      description: 'Create users through Json. We can either create single or multiple users at a time.

        Required fields to create a user is Login/Password/FirstName/LastName/Roles/Departments.'
      operationId: Users_CreateUser
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: string
            text/csv:
              schema:
                type: string
            application/json:
              schema:
                type: string
            text/json:
              schema:
                type: string
            application/xml:
              schema:
                type: string
            text/xml:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          application/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          text/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          application/x-www-form-urlencoded:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
        required: true
    delete:
      tags:
      - Users
      summary: Delete Users
      description: 'Delete users through Json. We can either delete single or multiple users at a time.

        Required fields to delete a user is Login.'
      operationId: Users_DeleteUser
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: string
            text/csv:
              schema:
                type: string
            application/json:
              schema:
                type: string
            text/json:
              schema:
                type: string
            application/xml:
              schema:
                type: string
            text/xml:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: string
          text/json:
            schema:
              type: array
              items:
                type: string
          application/xml:
            schema:
              type: array
              items:
                type: string
          text/xml:
            schema:
              type: array
              items:
                type: string
          application/x-www-form-urlencoded:
            schema:
              type: array
              items:
                type: string
        required: true
    patch:
      tags:
      - Users
      summary: Update User
      description: 'Update users through Json. We can either update single or multiple users at a time.

        Required fields to update a user is Login.'
      operationId: Users_UpdateUser
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: string
            text/csv:
              schema:
                type: string
            application/json:
              schema:
                type: string
            text/json:
              schema:
                type: string
            application/xml:
              schema:
                type: string
            text/xml:
              schema:
                type: string
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          text/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          application/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          text/xml:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
          application/x-www-form-urlencoded:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/UserDetail'
        required: true
components:
  schemas:
    KeyValue:
      type: object
      properties:
        Key:
          type: string
        Value:
          type: string
    UserGenericFieldsMapData:
      type: object
      properties:
        ID:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        UserGenericFieldID:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        FieldLabel:
          type: string
        FieldCode:
          type: string
        FieldValue:
          type: string
        UserCreated:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        DateCreated:
          format: date-time
          type: string
    Role:
      type: object
      properties:
        ID:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        Name:
          type: string
        Rank:
          format: int32
          type: integer
    KeyValuePair:
      description: ''
      type: object
      properties:
        Key:
          type: string
        Value:
          type: string
    Departmnt:
      type: object
      properties:
        ID:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        Name:
          type: string
        Description:
          type: string
    PageResult_AdvancedUserModel:
      type: object
      properties:
        Items:
          type: array
          items:
            $ref: '#/components/schemas/AdvancedUserModel'
        NextPageLink:
          type: string
        Count:
          format: int64
          type: integer
    UserDetail:
      description: TAP User Detail
      type: object
      properties:
        ID:
          format: uuid
          description: User ID
          type: string
          example: 00000000-0000-0000-0000-000000000000
        Login:
          description: Login
          type: string
        FirstName:
          description: First Name property
          maxLength: 50
          minLength: 0
          type: string
        LastName:
          description: Last Name property
          maxLength: 50
          minLength: 0
          type: string
        Password:
          description: Password property (not mandatory for updates)
          type: string
        UserName:
          description: UserName property
          type: string
        Roles:
          description: AssignedRoles property
          type: array
          items:
            format: uuid
            type: string
            example: 00000000-0000-0000-0000-000000000000
        Departments:
          description: AssignedDepartments property
          type: array
          items:
            format: uuid
            type: string
            example: 00000000-0000-0000-0000-000000000000
        IsPasswordChangeRequired:
          description: IsPasswordChangeRequired property
          type: boolean
        GenericFields:
          description: GenericFields property
          type: array
          items:
            $ref: '#/components/schemas/UserGenericFieldsMapData'
        IsDeleted:
          description: IsDeleted property
          type: boolean
        IsLockedOut:
          description: IsLockedOut property
          type: boolean
        CellNumber:
          description: CellNumber property
          type: string
        FaxNumber:
          description: FaxNumber
          type: string
        EmployeeID:
          description: EmployeeID property
          type: string
        Type:
          description: Type property
          type: string
        SisenseUserName:
          description: Sisense User Name
          type: string
        SisenseUserPassword:
          description: Sisense User Password
          type: string
    User:
      description: TAP User
      type: object
      properties:
        ID:
          format: uuid
          description: User ID
          type: string
          example: 00000000-0000-0000-0000-000000000000
        FullName:
          description: User name and surname
          type: string
        Email:
          description: User email
          type: string
        Roles:
          description: Roles assigned to user
          type: array
          items:
            type: string
        Departments:
          description: Departments assigned to user
          type: array
          items:
            type: string
        ESignKey:
          description: User`s esignature key
          type: string
        CustomFields:
          description: Custom fields
          type: array
          items:
            $ref: '#/components/schemas/KeyValuePair'
    AdvancedUserModel:
      type: object
      properties:
        ID:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        FullName:
          type: string
        Email:
          type: string
        Roles:
          type: array
          items:
            type: string
        Departments:
          type: array
          items:
            type: string
        ESignKey:
          type: string
        CustomFields:
          type: array
          items:
            $ref: '#/components/schemas/KeyValue'