vCita Service OAuth API
The Service OAuth API from vCita — 1 operation(s) for service oauth.
The Service OAuth API from vCita — 1 operation(s) for service oauth.
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-service-oauth-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: Apps Service OAuth API
description: Unified OpenAPI specification for apps domain
version: '3.0'
x-generated:
sourceFiles:
- apps.json
- navigation_items.json
- app_business_mappings.json
- legacy_v1_apps.json
- legacy_token.json
- widgets_and_boards.json
- legacy_app_translation.json
- jwks.json
pathNormalizations:
- file: legacy_v1_apps.json
basePath: /platform/v1
transformations:
- original: /apps
normalized: /platform/v1/apps
basePath: /platform/v1
- original: /apps/{id}
normalized: /platform/v1/apps/{id}
basePath: /platform/v1
- original: /apps/{id}/assign
normalized: /platform/v1/apps/{id}/assign
basePath: /platform/v1
- original: /apps/{id}/install_app
normalized: /platform/v1/apps/{id}/install_app
basePath: /platform/v1
- original: /apps/{id}/unassign
normalized: /platform/v1/apps/{id}/unassign
basePath: /platform/v1
- original: /apps/{id}/uninstall_app
normalized: /platform/v1/apps/{id}/uninstall_app
basePath: /platform/v1
- file: legacy_token.json
basePath: /oauth/service
transformations:
- original: /token
normalized: /oauth/service/token
basePath: /oauth/service
- file: legacy_app_translation.json
basePath: /platform/v1
transformations:
- original: /apps/translations/{app_code_name}
normalized: /platform/v1/apps/translations/{app_code_name}
basePath: /platform/v1
pathConflicts: []
componentConflicts:
- type: schema
name: ErrorResponse
resolution: Renamed to ErrorResponse_app_business_mappings
files:
- merged
- app_business_mappings.json
- type: schema
name: Response
resolution: Renamed to Response_widgets_and_boards
files:
- merged
- widgets_and_boards.json
totalPaths: 26
totalComponents: 26
servers:
- url: https://api.vcita.biz
description: Unified API Gateway server
tags:
- name: Service OAuth
paths:
/oauth/service/token:
post:
parameters: []
responses:
'200':
description: Service token generated
content:
application/json:
example:
access_token: eade05e0ee958ed139b7431b1a630bff95260178699ddf88cbd86a32d2ac708c
created_at: '2021-11-16T13:29:47.000Z'
expires_in: 3600
token_type: Bearer
'400':
description: Invalid credentials
'401':
description: Unauthorized
summary: Generate an app access token
description: '## Overview
Generate an app access token using OAuth client credentials flow. **No bearer token required** - authentication is via service_id and service_secret in the request body.
## Prerequisites
Requires an existing OAuth application. Create one using `POST /platform/v1/apps` to obtain `client_id` (service_id) and `client_secret` (service_secret).
## Parameters
- `service_id`: The OAuth application `client_id` - a 64-character hexadecimal string (e.g., `20cecc9cc620b717187922baa7706ceaf27b254afdb435ff955a913b3393a8f9`)
- `service_secret`: The OAuth application `client_secret` - a 64-character hexadecimal string
## How to Get Credentials
1. Create an app: `POST /platform/v1/apps` with directory token
2. Save the `client_id` and `client_secret` from the response
3. Use those values as `service_id` and `service_secret` in this endpoint
## Usage
This token can be used to create widgets (for apps with `app_type=[''widgets'']`) or notifications for the app.
Available for **Staff, Directory, and Client tokens**'
tags:
- Service OAuth
x-amazon-apigateway-auth:
type: NONE
x-amazon-apigateway-integration:
httpMethod: POST
responses:
default:
statusCode: '200'
type: http_proxy
uri: https:///oauth/service/token
x-auth-type: None
requestBody:
content:
application/json:
schema:
properties:
service_id:
description: The OAuth application client_id (UID). This is returned when creating an app via `POST /platform/v1/apps`. Must be a valid OAuth application credential.
type: string
service_secret:
description: The OAuth application client_secret. This is returned when creating an app via `POST /platform/v1/apps`. Must match the OAuth application credentials.
type: string
required:
- service_id
- service_secret
type: object
example:
service_id: 20cecc9cc620b717187922baa7706ceaf27b254afdb435ff955a913b3393a8f9
service_secret: 3f12b18a6d015cb99ca56e1abeeb885cf87cee824e7d021064ad446ed9aa3bb2
security: []
operationId: postOauthServiceToken
x-operation-id-source: derived
components:
securitySchemes:
NavigationItems:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid bearer token in the Authorization header. Example: ''Authorization: Bearer {token}'''
AppBusinessMappings:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Provide a valid Directory bearer token in the Authorization header (e.g., "Authorization: Bearer {directory_token}").'
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/appassignments_create.md
- https://developers.intandem.tech/reference/appassignments_delete.md
- https://developers.intandem.tech/reference/appassignments_list.md
- https://developers.intandem.tech/reference/apps_get.md
- https://developers.intandem.tech/reference/apps_list.md
- https://developers.intandem.tech/reference/businessappinstalls_create.md
- https://developers.intandem.tech/reference/businessappinstalls_destroy.md
- https://developers.intandem.tech/reference/businessappinstalls_list.md
- https://developers.intandem.tech/reference/businessappinstalls_show.md
- https://developers.intandem.tech/reference/createappbusinessmapping.md
- https://developers.intandem.tech/reference/createnavigationitem.md
- https://developers.intandem.tech/reference/deleteappbusinessmapping.md
- https://developers.intandem.tech/reference/deletenavigationitem.md
- https://developers.intandem.tech/reference/get_platform-v1-apps-id.md
- https://developers.intandem.tech/reference/get_platform-v1-apps.md
- https://developers.intandem.tech/reference/getappbusinessmapping.md
- https://developers.intandem.tech/reference/listappbusinessmappings.md
- https://developers.intandem.tech/reference/listnavigationitems.md
- https://developers.intandem.tech/reference/post_oauth-service-token.md
- https://developers.intandem.tech/reference/post_platform-v1-apps-id-assign.md
- https://developers.intandem.tech/reference/post_platform-v1-apps-id-install-app.md
- https://developers.intandem.tech/reference/post_platform-v1-apps-id-unassign.md
- https://developers.intandem.tech/reference/post_platform-v1-apps-id-uninstall-app.md
- https://developers.intandem.tech/reference/post_platform-v1-apps.md
- https://developers.intandem.tech/reference/post_v3-apps-compact-jws-tokens-bulk.md
- https://developers.intandem.tech/reference/post_v3-apps-compact-jws-tokens.md
- https://developers.intandem.tech/reference/put_platform-v1-apps-id.md
- https://developers.intandem.tech/reference/put_platform-v1-apps-translations-app-code-name.md
- https://developers.intandem.tech/reference/staffwidgetsboard_create.md
- https://developers.intandem.tech/reference/staffwidgetsboard_getall.md
- https://developers.intandem.tech/reference/staffwidgetsboard_update.md
- https://developers.intandem.tech/reference/staffwidgetsboardstemplate_create.md
- https://developers.intandem.tech/reference/staffwidgetsboardstemplate_delete.md
- https://developers.intandem.tech/reference/staffwidgetsboardstemplate_getall.md
- https://developers.intandem.tech/reference/staffwidgetsboardstemplate_update.md
- https://developers.intandem.tech/reference/updateappbusinessmapping.md
- https://developers.intandem.tech/reference/updatenavigationitem.md
- https://developers.intandem.tech/reference/widgets_create.md
- https://developers.intandem.tech/reference/widgets_getall.md
- https://developers.intandem.tech/reference/widgets_update.md
- https://developers.intandem.tech:443/reference/appassignments_create.md
- https://developers.intandem.tech:443/reference/appassignments_delete.md
- https://developers.intandem.tech:443/reference/appassignments_list.md
- https://developers.intandem.tech:443/reference/apps_get.md
- https://developers.intandem.tech:443/reference/apps_list.md
- https://developers.intandem.tech:443/reference/businessappinstalls_create.md
- https://developers.intandem.tech:443/reference/businessappinstalls_destroy.md
- https://developers.intandem.tech:443/reference/businessappinstalls_list.md
- https://developers.intandem.tech:443/reference/businessappinstalls_show.md
- https://developers.intandem.tech:443/reference/createappbusinessmapping.md
- https://developers.intandem.tech:443/reference/createnavigationitem.md
- https://developers.intandem.tech:443/reference/deleteappbusinessmapping.md
- https://developers.intandem.tech:443/reference/deletenavigationitem.md
- https://developers.intandem.tech:443/reference/get_platform-v1-apps-id.md
- https://developers.intandem.tech:443/reference/get_platform-v1-apps.md
- https://developers.intandem.tech:443/reference/getappbusinessmapping.md
- https://developers.intandem.tech:443/reference/listappbusinessmappings.md
- https://developers.intandem.tech:443/reference/listnavigationitems.md
- https://developers.intandem.tech:443/reference/post_oauth-service-token.md
- https://developers.intandem.tech:443/reference/post_platform-v1-apps-id-assign.md
- https://developers.intandem.tech:443/reference/post_platform-v1-apps-id-install-app.md
- https://developers.intandem.tech:443/reference/post_platform-v1-apps-id-unassign.md
- https://developers.intandem.tech:443/reference/post_platform-v1-apps-id-uninstall-app.md
- https://developers.intandem.tech:443/reference/post_platform-v1-apps.md
- https://developers.intandem.tech:443/reference/post_v3-apps-compact-jws-tokens-bulk.md
- https://developers.intandem.tech:443/reference/post_v3-apps-compact-jws-tokens.md
- https://developers.intandem.tech:443/reference/put_platform-v1-apps-id.md
- https://developers.intandem.tech:443/reference/put_platform-v1-apps-translations-app-code-name.md
- https://developers.intandem.tech:443/reference/staffwidgetsboard_create.md
- https://developers.intandem.tech:443/reference/staffwidgetsboard_getall.md
- https://developers.intandem.tech:443/reference/staffwidgetsboard_update.md
- https://developers.intandem.tech:443/reference/staffwidgetsboardstemplate_create.md
- https://developers.intandem.tech:443/reference/staffwidgetsboardstemplate_delete.md
- https://developers.intandem.tech:443/reference/staffwidgetsboardstemplate_getall.md
- https://developers.intandem.tech:443/reference/staffwidgetsboardstemplate_update.md
- https://developers.intandem.tech:443/reference/updateappbusinessmapping.md
- https://developers.intandem.tech:443/reference/updatenavigationitem.md
- https://developers.intandem.tech:443/reference/widgets_create.md
- https://developers.intandem.tech:443/reference/widgets_getall.md
- https://developers.intandem.tech:443/reference/widgets_update.md
merge:
pages: 80
deduped: 211
conflicts_kept_first: 0