Rhombus Systems Service Management Integrations Webservice API
The Service Management Integrations Webservice API from Rhombus Systems — 14 operation(s) for service management integrations webservice.
The Service Management Integrations Webservice API from Rhombus Systems — 14 operation(s) for service management integrations webservice.
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/rhombus-systems-service-management-integrations-webservice-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
contact:
email: developer@rhombussystems.com
description: 'This API is for use by Rhombus customers and partners.
## Authentication
All requests require two headers:
- `x-auth-scheme` — The authentication scheme identifier. Use `api-token` for standard API key auth, or `partner-api-token` for partner API auth.
- `x-auth-apikey` — Your Rhombus API key.
Example:
```
POST /api/camera/getMinimalCameraStateList
x-auth-scheme: api-token
x-auth-apikey: YOUR_API_KEY
Content-Type: application/json
```'
title: Rhombus Service Management Integrations Webservice API
version: '1.0'
servers:
- description: Production Server
url: https://api2.rhombussystems.com
security:
- ApiKeyAuth: []
tags:
- name: Service Management Integrations Webservice
paths:
/api/integrations/serviceManagement/createEnvoyInvite:
post:
description: Create an invite with Envoy
operationId: createEnvoyInvite
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_CreateEnvoyInviteWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/BaseApiResponse'
description: OK
summary: Create Envoy invite
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/deleteEnvoyIntegration:
post:
deprecated: true
description: Delete Envoy badge integration
operationId: deleteEnvoyIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/BaseApiResponse'
description: OK
summary: Delete Envoy integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/deleteEnvoyIntegrationV2:
post:
description: Delete Envoy integration
operationId: deleteEnvoyIntegrationV2
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/BaseApiResponse'
description: OK
summary: Delete Envoy integration V2
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/deleteToastIntegration:
post:
deprecated: true
description: Delete Toast integration
operationId: deleteToastIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/BaseApiResponse'
description: OK
summary: Delete Toast integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/deleteToastIntegrationV2:
post:
description: Delete Toast integration
operationId: deleteToastIntegrationV2
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/BaseApiResponse'
description: OK
summary: Delete Toast integration V2
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/getCalendlyEventDetails:
post:
description: Get Calendly event details
operationId: getCalendlyEventDetails
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetCalendlyEventDetailsWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetCalendlyEventDetailsWSResponse'
description: OK
summary: Get Calendly event details
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/getEnvoyIntegration:
post:
description: Get Envoy integration
operationId: getEnvoyIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetOrgIntegrationsV2WSResponse'
description: OK
summary: Get Envoy integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/getToastIntegration:
post:
description: Get Toast integration
operationId: getToastIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_BaseIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetOrgIntegrationsV2WSResponse'
description: OK
summary: Get Toast integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/getToastServiceAreas:
post:
description: Get list of Toast service areas to assign cameras
operationId: getToastServiceAreas
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetToastServiceAreasWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_GetToastServiceAreasWSResponse'
description: OK
summary: Get Toast service areas
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/initiateEnvoyOAuth:
post:
description: Initiate the Envoy OAuth Process
operationId: initiateEnvoyOAuth
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_InitiateOAuthWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_InitiateOAuthWSResponse'
description: OK
summary: Initiate Envoy OAuth
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/updateEnvoyIntegration:
post:
deprecated: true
description: Update Envoy badge integration
operationId: updateEnvoyIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateEnvoyIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateOrgIntegrationsWSResponse'
description: OK
summary: Update Envoy integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/updateEnvoyIntegrationV2:
post:
description: Update Envoy integration
operationId: updateEnvoyIntegrationV2
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateEnvoyIntegrationV2WSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateOrgIntegrationsWSResponse'
description: OK
summary: Update Envoy integration V2
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/updateToastIntegration:
post:
deprecated: true
description: Update Toast integration
operationId: updateToastIntegration
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateToastIntegrationWSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateOrgIntegrationsWSResponse'
description: OK
summary: Update Toast integration
tags:
- Service Management Integrations Webservice
/api/integrations/serviceManagement/updateToastIntegrationV2:
post:
description: Update Toast integration
operationId: updateToastIntegrationV2
parameters:
- description: Authentication scheme identifier. Use `api-token` for standard API key authentication, `partner-api-token` for partner API key authentication. Must be paired with the `x-auth-apikey` header containing your API key.
example: api-token
in: header
name: x-auth-scheme
required: true
schema:
type: string
default: api-token
enum:
- api-token
- api
- partner-api-token
- partner-api
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateToastIntegrationV2WSRequest'
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Integration_UpdateOrgIntegrationsWSResponse'
description: OK
summary: Update Toast integration V2
tags:
- Service Management Integrations Webservice
components:
schemas:
EnvoyInvite:
type: object
properties:
customFields:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/EnvoyCustomField'
expectedArrivalAt:
type:
- string
- 'null'
expectedDepartureAt:
type:
- string
- 'null'
flowId:
type:
- string
- 'null'
hostEmployeeId:
type:
- string
- 'null'
inviteId:
type:
- string
- 'null'
invitee:
$ref: '#/components/schemas/EnvoyPersonInfo'
locationId:
type:
- string
- 'null'
notes:
type:
- string
- 'null'
sendEmailToInvitee:
type:
- boolean
- 'null'
Integration_UpdateEnvoyIntegrationV2WSRequest:
type: object
description: Request object for updating Envoy V2 integration settings with enhanced visitor management features.
properties:
envoySettings:
$ref: '#/components/schemas/IEnvoyType'
EnvoyLocationInfoType:
type:
- object
- 'null'
properties:
assignedCameraList:
type:
- array
- 'null'
items:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
locationName:
type:
- string
- 'null'
ToastSettings:
type: object
description: Toast POS integration settings to update
properties:
currentToastRestaurantGuid:
type:
- string
- 'null'
description: The current restaurant guid you want to use
enabled:
type:
- boolean
- 'null'
enabledTimestampMs:
type:
- integer
- 'null'
format: int64
enablingUser:
type:
- string
- 'null'
enablingUserUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
migrated:
type:
- boolean
- 'null'
posInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/PosIntegrationInfoType'
description: A HashMap of <Service Area Guid, PosIntegrationInfoType>. This stores the Pos Information and assigned cameras.
toastRestaurantInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/ToastRestaurantInfo'
description: A HashMap of <Restaurant Guid, ToastRestaurantInfo>. This stores the information for each restaurant.
ToastRestaurantInfo:
type: object
description: A HashMap of <Restaurant Guid, ToastRestaurantInfo>. This stores the information for each restaurant.
properties:
locationName:
type:
- string
- 'null'
description: The location name of the restaurant from Toast
restaurantName:
type:
- string
- 'null'
description: The name of the restaurant from Toast. e.g., COFFEE CAN
DeviceIntegrationSettings:
type:
- object
- 'null'
properties:
latitude:
type:
- number
- 'null'
format: double
longitude:
type:
- number
- 'null'
format: double
name:
type:
- string
- 'null'
Integration_GetOrgIntegrationsV2WSResponse:
type: object
properties:
error:
type:
- boolean
- 'null'
errorMsg:
type:
- string
- 'null'
orgIntegrationV2:
$ref: '#/components/schemas/IBaseIntegrationType'
warningMsg:
type:
- string
- 'null'
GenericPosSettings:
type:
- object
- 'null'
description: Collection of service area settings for this restaurant
properties:
assignedCameraList:
type:
- array
- 'null'
description: A list of camera uuids from Rhombus that are assigned to the PoS device
items:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
posName:
type:
- string
- 'null'
description: The name of the point of sale device
HoneywellNetBoxType:
type:
- object
- 'null'
allOf:
- type: object
properties:
alertUnauthorizedFaces:
type:
- boolean
- 'null'
apiToken:
type:
- string
- 'null'
badgeAuthDisablesAlarmMonitoring:
type:
- boolean
- 'null'
badgeFaceVerificationMode:
$ref: '#/components/schemas/BadgeFaceVerificationModeEnum'
baseUrl:
type:
- string
- 'null'
createAccessAnomalyAlerts:
type:
- boolean
- 'null'
createSeekPoints:
type:
- boolean
- 'null'
doorInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/BadgeIntegrationDoorInfoType'
doorsValidated:
type:
- boolean
- 'null'
identifyFacesFromBadge:
type:
- boolean
- 'null'
indexFaces:
type:
- boolean
- 'null'
misconfiguredDoors:
type:
- array
- 'null'
items:
type:
- string
- 'null'
refreshToken:
type:
- string
- 'null'
rhombusToken:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
saveClips:
type:
- boolean
- 'null'
tokenValid:
type:
- boolean
- 'null'
properties:
enabled:
type:
- boolean
- 'null'
integration:
$ref: '#/components/schemas/IntegrationEnum'
integrationAuditMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/IntegrationAuditEvent'
orgUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
userUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
MicrosoftTeamsChannelSettings:
type:
- object
- 'null'
properties:
botInstallationId:
type:
- string
- 'null'
channelId:
type:
- string
- 'null'
installingUserUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
sendChannelNotifications:
type:
- boolean
- 'null'
EnvoyCustomField:
type: object
properties:
field:
type:
- string
- 'null'
value:
type:
- string
- 'null'
AvigilonAltaType:
type:
- object
- 'null'
allOf:
- type: object
properties:
alertUnauthorizedFaces:
type:
- boolean
- 'null'
apiToken:
type:
- string
- 'null'
badgeAuthDisablesAlarmMonitoring:
type:
- boolean
- 'null'
badgeFaceVerificationMode:
$ref: '#/components/schemas/BadgeFaceVerificationModeEnum'
createAccessAnomalyAlerts:
type:
- boolean
- 'null'
createSeekPoints:
type:
- boolean
- 'null'
doorInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/BadgeIntegrationDoorInfoType'
doorToCameraMap:
type:
- object
- 'null'
additionalProperties:
type:
- array
- 'null'
items:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
doorsValidated:
type:
- boolean
- 'null'
email:
type:
- string
- 'null'
eventToWebhookIdMap:
type:
- object
- 'null'
additionalProperties:
type:
- integer
- 'null'
format: int32
eventToWebhookMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/WebhookMapEntry'
identifyFacesFromBadge:
type:
- boolean
- 'null'
indexFaces:
type:
- boolean
- 'null'
misconfiguredDoors:
type:
- array
- 'null'
items:
type:
- string
- 'null'
password:
type:
- string
- 'null'
refreshToken:
type:
- string
- 'null'
rhombusToken:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
saveClips:
type:
- boolean
- 'null'
tokenValid:
type:
- boolean
- 'null'
webhookId:
type:
- integer
- 'null'
format: int32
properties:
enabled:
type:
- boolean
- 'null'
integration:
$ref: '#/components/schemas/IntegrationEnum'
integrationAuditMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/IntegrationAuditEvent'
orgUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
userUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
OpentechAllianceDoorInfoType:
type:
- object
- 'null'
properties:
actionGroupId:
type:
- string
- 'null'
assignedCameraList:
type:
- array
- 'null'
items:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
clipDuration:
type:
- integer
- 'null'
format: int32
doorName:
type:
- string
- 'null'
leadingSeconds:
type:
- integer
- 'null'
format: int32
locationUuid:
type:
- string
- 'null'
format: RUUID
description: base 64 (url-safe) uuid string
example: AAAAAAAAAAAAAAAAAAAAAA
remoteUnlock:
type:
- boolean
- 'null'
subLocationsHierarchyKey:
type:
- string
- 'null'
format: SubLocationsHierarchyKey
description: 'A sequence of one or more base 64 (url-safe) uuid substrings.
These substrings are separated by dots (.).
'
example: AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA.AAAAAAAAAAAAAAAAAAAAAA
pattern: ^([A-Za-z0-9\-_]{22})([.][A-Za-z0-9\-_]{22})*$
Integration_UpdateToastIntegrationV2WSRequest:
type: object
properties:
restaurantGuids:
type:
- array
- 'null'
items:
type:
- string
- 'null'
toastSettings:
$ref: '#/components/schemas/IToastType'
ButterflyMXType:
type:
- object
- 'null'
allOf:
- type: object
properties:
alertUnauthorizedFaces:
type:
- boolean
- 'null'
apiToken:
type:
- string
- 'null'
badgeAuthDisablesAlarmMonitoring:
type:
- boolean
- 'null'
badgeFaceVerificationMode:
$ref: '#/components/schemas/BadgeFaceVerificationModeEnum'
buildingWebhookIdMap:
type:
- object
- 'null'
additionalProperties:
type:
- string
- 'null'
description: 'A HashMap of <ButterflyMx Building Id, Webhook Id>. '
description: 'A HashMap of <ButterflyMx Building Id, Webhook Id>. '
createAccessAnomalyAlerts:
type:
- boolean
- 'null'
createSeekPoints:
type:
- boolean
- 'null'
doorInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/BadgeIntegrationDoorInfoType'
doorsValidated:
type:
- boolean
- 'null'
identifyFacesFromBadge:
type:
- boolean
- 'null'
indexFaces:
type:
- boolean
- 'null'
misconfiguredDoors:
type:
- array
- 'null'
items:
type:
- string
- 'null'
panelInfoMap:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/ButterflymxPanelInfoType'
description: A HashMap of <Panel Id,
# --- truncated at 32 KB (112 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/rhombus-systems/refs/heads/main/openapi/rhombus-systems-service-management-integrations-webservice-api-openapi.yml