Confrere — start and end a video session

arazzo: 1.0.1
info:
  title: Confrere — start and end a video session
  version: 1.0.0
  summary: >-
    Mint a single-use room URL for a participant, then end the session by
    invalidating the room.
# generated: '2026-07-18'
# method: derived
# source: openapi/confrere-video-openapi.yml
sourceDescriptions:
- name: roomApi
  url: ../openapi/confrere-room-api-openapi.yml
  type: openapi
- name: tokenApi
  url: ../openapi/confrere-token-api-openapi.yml
  type: openapi
workflows:
- workflowId: startAndEndVideoSession
  summary: Create a room URL for a user, then invalidate the room to end the session.
  description: >-
    Uses operationPath references because the published spec ships no
    operationIds. Step 1 mints a one-minute, single-use redirect URL; after
    the meeting, step 2 invalidates the room so all tokens are revoked and the
    room is destroyed.
  inputs:
    type: object
    properties:
      roomId:
        type: string
        example: myintegration:consult-123
      userId:
        type: string
        example: user-42
  steps:
  - stepId: createRoomToken
    description: Create the room and get the redirect URL for the participant.
    operationPath: $sourceDescriptions.confrere.url#/paths/~1api~1token/post
    requestBody:
      contentType: application/json
      payload:
        roomId: $inputs.roomId
        userId: $inputs.userId
        role: moderator
        useLobby: true
    outputs:
      roomUrl: $response.body#/url
  - stepId: invalidateRoom
    description: End the session by invalidating the room and all its tokens.
    operationPath: $sourceDescriptions.confrere.url#/paths/~1api~1room~1{id}~1invalidate/post
    parameters:
    - name: id
      in: path
      value: $inputs.roomId
  outputs:
    roomUrl: $steps.createRoomToken.outputs.roomUrl