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.
The IDP Actor API facilitates seamless CRUD operations for managing users in an IDP integrated with SSO to the inTandem authorization bridge.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/vcita:vcita-idp-actor-mapping-api"
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.
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: 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