Flowdock (Discontinued)

Flowdock SCIM Provisioning API

Partial SCIM 1.x user provisioning API for CA Flowdock Enterprise customers with Single Sign-On configured. Bearer-token authenticated. Now offline.

Flowdock SCIM Provisioning API is one of 4 APIs that Flowdock (Discontinued) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 machine-runnable capability that can be deployed as REST, MCP, or Agent Skill surfaces via Naftiko.

Tagged areas include SCIM, SSO, Provisioning, Enterprise, and Discontinued. The published artifact set on APIs.io includes API documentation, an OpenAPI specification, sample payloads, and 1 Naftiko capability spec.

GitHub OpenAPI

Documentation

📖
Documentation
https://github.com/flowdock/api-docs/blob/master/docs/scim.md

Specifications

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

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/flowdock/refs/heads/main/examples/flowdock-scim-user-response.json

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/flowdock/refs/heads/main/capabilities/shared/flowdock-scim-api.yaml

OpenAPI Specification

flowdock-scim-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: Flowdock SCIM Provisioning API
  version: "1.0"
  x-status: discontinued
  x-shutdown-date: "2023-08-15"
  description: |
    Partial SCIM (System for Cross-Domain Identity Management) provisioning
    API for CA Flowdock Enterprise customers with Single Sign-On configured.
    Used by IdP-side provisioning connectors to create, read, update, and
    deactivate SSO-linked user accounts in a Flowdock organization.

    Discontinued with the rest of Flowdock on August 15, 2023.
    Reconstructed from https://github.com/flowdock/api-docs/blob/master/docs/scim.md.
servers:
  - url: https://api.flowdock.com
    description: Historical production base URL (offline since 2023-08-15)
security:
  - bearerAuth: []
tags:
  - name: SCIM
    description: SCIM 1.x user provisioning for SSO-enabled Flowdock organizations.
paths:
  /scim/{uid}:
    get:
      tags: [SCIM]
      summary: Verify SCIM Authorization
      operationId: scimRoot
      parameters:
        - $ref: "#/components/parameters/Uid"
      responses:
        "200":
          description: Authorization OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message: { type: string }
        "401": { description: Missing authorization header. }
        "403": { description: Invalid or wrong-token authorization header. }
        "429": { description: Rate-limited; retry later. }
  /scim/{uid}/Users:
    get:
      tags: [SCIM]
      summary: List SCIM Users
      operationId: scimListUsers
      parameters:
        - $ref: "#/components/parameters/Uid"
      responses:
        "200":
          description: SCIM Users collection.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Resources:
                    type: array
                    items: { $ref: "#/components/schemas/ScimUser" }
    post:
      tags: [SCIM]
      summary: Provision SCIM User
      operationId: scimCreateUser
      parameters:
        - $ref: "#/components/parameters/Uid"
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: "#/components/schemas/ScimUser" }
      responses:
        "201":
          description: User provisioned.
          content:
            application/json:
              schema: { $ref: "#/components/schemas/ScimUser" }
  /scim/{uid}/Users/{id}:
    get:
      tags: [SCIM]
      summary: Get SCIM User
      operationId: scimGetUser
      parameters:
        - $ref: "#/components/parameters/Uid"
        - name: id
          in: path
          required: true
          schema: { type: integer }
      responses:
        "200":
          description: User resource.
          content:
            application/json:
              schema: { $ref: "#/components/schemas/ScimUser" }
    put:
      tags: [SCIM]
      summary: Update SCIM User
      operationId: scimUpdateUser
      parameters:
        - $ref: "#/components/parameters/Uid"
        - name: id
          in: path
          required: true
          schema: { type: integer }
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: "#/components/schemas/ScimUser" }
      responses:
        "200": { description: User updated. }
    delete:
      tags: [SCIM]
      summary: Deactivate SCIM User
      operationId: scimDeleteUser
      parameters:
        - $ref: "#/components/parameters/Uid"
        - name: id
          in: path
          required: true
          schema: { type: integer }
      responses:
        "204": { description: User deactivated. }
components:
  parameters:
    Uid:
      name: uid
      in: path
      required: true
      description: SSO organization UID issued during SSO setup.
      schema: { type: string }
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: SCIM bearer token issued during SSO setup.
  schemas:
    ScimUser:
      type: object
      properties:
        id: { type: integer }
        externalId: { type: string }
        userName: { type: string, format: email }
        nickName: { type: string }
        name:
          type: object
          properties:
            givenName: { type: string }
            familyName: { type: string }
        emails:
          type: array
          items:
            type: object
            properties:
              value: { type: string, format: email }
        meta:
          type: object
          properties:
            location: { type: string, format: uri }
            created: { type: string, format: date-time }
            lastModified: { type: string, format: date-time }