vCita IDP Actor Mapping API

The IDP Actor API facilitates seamless CRUD operations for managing users in an IDP integrated with SSO to the inTandem authorization bridge.

GitHub OpenAPI

Operations 3

GET /v3/integrations/idp_actor_mappings List all IDP Actor Mappings #
POST /v3/integrations/idp_actor_mappings Create an IDP Actor Mapping #
DELETE /v3/integrations/idp_actor_mappings/{uid} Delete an IDP Actor Mapping #

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/vcita:vcita-idp-actor-mapping-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

vcita-idp-actor-mapping-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Integrations IDP Actor Mapping API
  description: Unified OpenAPI specification for integrations domain
  version: '3.0'
  x-generated:
    sourceFiles:
    - import.json
    - authbridge.json
    pathNormalizations:
    - file: authbridge.json
      basePath: /v3
      transformations:
      - original: /integrations/idp_actor_mappings
        normalized: /v3/integrations/idp_actor_mappings
        basePath: /v3
      - original: /integrations/idp_actor_mappings/{uid}
        normalized: /v3/integrations/idp_actor_mappings/{uid}
        basePath: /v3
      - original: /integrations/directory_idps
        normalized: /v3/integrations/directory_idps
        basePath: /v3
      - original: /integrations/directory_idps/{uid}
        normalized: /v3/integrations/directory_idps/{uid}
        basePath: /v3
    pathConflicts: []
    componentConflicts: []
    totalPaths: 8
    totalComponents: 11
servers:
- url: https://api.vcita.biz
  description: Unified API Gateway server
tags:
- name: IDP Actor Mapping
  description: The IDP Actor API facilitates seamless CRUD operations for managing users in an IDP integrated with SSO to the inTandem authorization bridge.
paths:
  /v3/integrations/idp_actor_mappings:
    get:
      summary: List all IDP Actor Mappings
      parameters:
      - in: query
        name: idp_user_reference_id
        schema:
          type: string
        description: Filter by external reference ID of the IDP User
      - in: query
        name: actor_type
        schema:
          type: string
          enum:
          - staff
          - operator
        description: Filter by actor type. 'staff' refers to a staff member, while 'operator' refers to an operator in the Operators Portal.
      - in: query
        name: actor_uid
        schema:
          type: string
        description: Filter by unique identifier of the actor in the inTandem platform
      - in: query
        name: page
        schema:
          type: integer
          default: 1
        description: Page number of the results
      - in: query
        name: per_page
        schema:
          type: integer
          default: 25
          maximum: 100
        description: How many items to return per page
      - in: query
        name: sort
        schema:
          type: string
          default: updated_at:desc
        description: Sort by fields, e.g., "created_at:asc,updated_at:desc"
      responses:
        '200':
          description: A list of IDP Actor Mappings
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/paths/~1v3~1integrations~1directory_idps/get/responses/200/content/application~1json/schema/allOf/0'
                - properties:
                    data:
                      $ref: '#/components/schemas/IdpActorList'
      tags:
      - IDP Actor Mapping
      description: '## Overview

        List all IDP Actor Mappings in the directory scope.'
      security:
      - Bearer: []
      operationId: getV3IntegrationsIdpActorMappings
      x-operation-id-source: derived
    post:
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateIdpActorMappingDTO'
        required: true
      responses:
        '201':
          description: IDP Actor Mapping created successfully
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/paths/~1v3~1integrations~1directory_idps/get/responses/200/content/application~1json/schema/allOf/0'
                - properties:
                    data:
                      $ref: '#/components/schemas/IdpActorList/properties/idp_actor_mappings/items'
        '400':
          description: Bad Request - Invalid input data or missing required fields
        '401':
          description: Unauthorized - Invalid or missing authentication token
        '403':
          description: Forbidden - Insufficient permissions or not a Directory Token
        '422':
          description: Unprocessable Entity - Business logic validation failed (e.g., invalid actor_uid or actor_type combination)
      summary: Create an IDP Actor Mapping
      description: '## Overview

        Create a new IDP Actor Mapping for SSO integration Available for **Directory Tokens only**.'
      tags:
      - IDP Actor Mapping
      security:
      - Bearer: []
      operationId: postV3IntegrationsIdpActorMappings
      x-operation-id-source: derived
  /v3/integrations/idp_actor_mappings/{uid}:
    delete:
      summary: Delete an IDP Actor Mapping
      description: '## Overview

        Delete an IDP Actor Mapping by UID. Available for **Directory Tokens only**.'
      parameters:
      - name: uid
        in: path
        required: true
        description: The unique identifier of the IDP Actor Mapping
        schema:
          type: string
      responses:
        '204':
          description: IDP Actor Mapping deleted successfully
        '401':
          description: Unauthorized - Invalid or missing authentication token
        '403':
          description: Forbidden - Insufficient permissions or not a Directory Token
        '404':
          description: Not Found - IDP Actor Mapping with the specified UID does not exist
      tags:
      - IDP Actor Mapping
      security:
      - Bearer: []
      operationId: deleteV3IntegrationsIdpActorMappingsByUid
      x-operation-id-source: derived
components:
  schemas:
    IdpActorList:
      type: object
      properties:
        idp_actor_mappings:
          description: List of IDP Actor Mappings
          type: array
          items:
            type: object
            properties:
              uid:
                type: string
                description: Unique identifier of the IDP actor (a user in an IDP integrated with SSO to the inTandem autheriation bridge)
              idp_user_reference_id:
                type: string
                description: External reference ID of the IDP user, used to link the IDP actor to an external system.
              actor_type:
                type: string
                default: staff
                enum:
                - staff
                - operator
                description: Type of the actor in the inTandem platform. 'staff' refers to a staff member, while 'operator' refers to an operator in the Operators Portal.
              actor_uid:
                type: string
                description: Unique identifier of the actor in the inTandem platform. This is used to link the IDP actor to a specific staff member or operator.
              created_at:
                type: string
                format: date-time
                description: Creation timestamp
              updated_at:
                type: string
                format: date-time
                description: Last update timestamp
            required:
            - uid
            - idp_user_reference_id
            - actor_type
            - actor_uid
            - created_at
            - updated_at
            example:
              uid: '12345'
              idp_user_reference_id: ext-12345
              actor_type: staff
              actor_uid: staff-67890
              created_at: '2023-10-01T12:00:00Z'
              updated_at: '2023-10-01T12:00:00Z'
            description: Maps an external IDP user to an inTandem platform actor (staff or operator).
    CreateIdpActorMappingDTO:
      type: object
      properties:
        idp_user_reference_id:
          type: string
          description: External reference ID of the IDP User, used to link the IDP User to an external system.
          example: ext-12345
        actor_type:
          type: string
          enum:
          - staff
          - operator
          description: Type of the actor in the inTandem platform. 'staff' refers to a staff member, while 'operator' refers to an operator in the Operators Portal.
          example: staff
        actor_uid:
          type: string
          description: Unique identifier of the actor in the inTandem platform. This is used to link the IDP actor to a specific staff member or operator.
          example: staff-67890
      required:
      - idp_user_reference_id
      - actor_type
      - actor_uid
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {app_token}'''
x-provenance:
  method: searched
  source: https://developers.intandem.tech:443/reference
  harvested: '2026-11-15'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developers.intandem.tech/reference/delete_v3-integrations-idp-actor-mappings-uid.md
  - https://developers.intandem.tech/reference/get_v3-integrations-idp-actor-mappings.md
  - https://developers.intandem.tech/reference/importjobitemscontroller_findall.md
  - https://developers.intandem.tech/reference/importjobitemscontroller_findone.md
  - https://developers.intandem.tech/reference/importjobscontroller_create.md
  - https://developers.intandem.tech/reference/importjobscontroller_findone.md
  - https://developers.intandem.tech/reference/post_v3-integrations-idp-actor-mappings.md
  - https://developers.intandem.tech:443/reference/delete_v3-integrations-idp-actor-mappings-uid.md
  - https://developers.intandem.tech:443/reference/get_v3-integrations-idp-actor-mappings.md
  - https://developers.intandem.tech:443/reference/importjobitemscontroller_findall.md
  - https://developers.intandem.tech:443/reference/importjobitemscontroller_findone.md
  - https://developers.intandem.tech:443/reference/importjobscontroller_create.md
  - https://developers.intandem.tech:443/reference/importjobscontroller_findone.md
  - https://developers.intandem.tech:443/reference/post_v3-integrations-idp-actor-mappings.md
  merge:
    pages: 14
    deduped: 40
    conflicts_kept_first: 0