vCita Service OAuth API

The Service OAuth API from vCita — 1 operation(s) for service oauth.

GitHub OpenAPI

Operations 1

POST /oauth/service/token Generate an app access token #

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-service-oauth-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-service-oauth-api-openapi.yml Raw ↑
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