RingCentral High Volume SMS API

openapi: 3.2.0
info:
  title: RingCentral Adaptive Cards High Volume SMS API
  description: RingCentral API specification
  version: 1.0.58-20240529-47eda8bd
  contact:
    name: RingCentral Developers Support
    url: https://developers.ringcentral.com/support
  termsOfService: https://www.ringcentral.com/legal/apilitos.html
  license:
    name: RingCentral API License Agreement
    url: https://www.ringcentral.com/legal/apilitos.html
servers:
- url: https://platform.ringcentral.com
  description: Production API entry point
- url: https://media.ringcentral.com
  description: Production Media entry point
- url: https://platform.devtest.ringcentral.com
  description: Developer sandbox API entry point
- url: https://platform.devtest.ringcentral.com
  description: Developer sandbox Media entry point
security:
- OAuth2: []
tags:
- name: High Volume SMS
paths:
  /restapi/v1.0/account/{accountId}/a2p-sms/statuses:
    get:
      tags:
      - High Volume SMS
      summary: List A2P SMS Statuses
      description: Retrieves a set of message counts by message status and error codes filtered by dates, batchId and message direction.
      operationId: aggregateA2PSMSStatuses
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/QueryBatchId'
      - $ref: '#/components/parameters/SmsDirection'
      - $ref: '#/components/parameters/SmsDateFrom'
      - $ref: '#/components/parameters/SmsDateTo'
      - name: phoneNumber
        in: query
        required: false
        style: form
        explode: true
        description: List of phone numbers (specified in 'to' or 'from' fields of a message) to filter the results. Maximum number of phone numbers allowed to be specified as filters is 15
        schema:
          type: array
          items:
            type: string
        example:
        - '15551234455'
        - '15551235577'
      responses:
        '200':
          description: The statuses of the messages sent by the account filtered by criteria specified in the query
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageStatusesResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: No resource found for the account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/messages:
    get:
      tags:
      - High Volume SMS
      summary: List A2P SMS Messages
      description: Returns the list of outbound/inbound A2P messages sent from/to A2P phone numbers of the current account. The list can be filtered by message batch ID and/or phone number.
      operationId: listA2PSMS
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/QueryBatchId'
      - $ref: '#/components/parameters/SmsDirection'
      - $ref: '#/components/parameters/SmsDateFrom'
      - $ref: '#/components/parameters/SmsDateTo'
      - name: view
        in: query
        required: false
        description: Indicates if the response has to be detailed, includes text in the response if detailed
        schema:
          type: string
          default: Simple
          enum:
          - Simple
          - Detailed
      - name: phoneNumber
        in: query
        required: false
        style: form
        explode: true
        description: List of phone numbers (specified in 'to' or 'from' fields of a message) to filter the results. Maximum number of phone numbers allowed to be specified as filters is 15
        schema:
          type: array
          items:
            type: string
        example:
        - '15551234455'
        - '15551235577'
      - name: pageToken
        in: query
        required: false
        description: The page token of the page to be retrieved.
        schema:
          type: string
        example: pgt1
      - name: perPage
        in: query
        required: false
        description: The number of messages to be returned per request
        schema:
          type: integer
          format: int32
          default: 1000
        example: 1
      responses:
        '200':
          description: 'The list of messages sent by the account and filtered by the criteria specified in the query parameters

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageListResponse'
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: No resource found for the account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/messages/{messageId}:
    get:
      tags:
      - High Volume SMS
      summary: Get A2P SMS
      description: Returns the details of an A2P SMS message by ID.
      operationId: readA2PSMS
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - name: messageId
        in: path
        description: Internal identifier of a message to be retrieved
        required: true
        schema:
          type: string
        example: '1234'
      responses:
        '200':
          description: The message is found and returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageDetailsResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: The message is not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Service is not available
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/opt-outs:
    get:
      tags:
      - High Volume SMS
      summary: List Opted Out Numbers
      description: 'Returns the list of numbers opted out from the account. The list

        can be filtered by `to`/`from` phone number query parameters. Specifying `text/csv`

        in the `Accept` header lets download the data in the CSV format.

        '
      operationId: readA2PSMSOptOuts
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - name: from
        in: query
        required: false
        description: 'The sender''s phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format for filtering messages.

          The asterisk value "*" means any number in `from` field

          '
        schema:
          type: string
        example: '15551234455'
      - name: to
        in: query
        required: false
        description: 'The receiver''s phone number (`to` field) in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format for filtering messages

          '
        example: '15551237755'
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: The status (opted out, opted in, or both) to be used as the filter
        schema:
          type: string
          default: optout
          enum:
          - optout
          - optin
          - all
        example: optout
      - name: pageToken
        in: query
        required: false
        description: The page token of the page to be retrieved
        schema:
          type: string
        example: pgt1
      - name: perPage
        in: query
        required: false
        description: The number of records to be returned for the page
        schema:
          type: integer
          format: int32
          default: 1000
        example: 5
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptOutListResponse'
            text/csv:
              schema:
                $ref: '#/components/schemas/OptOutListResponse'
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: No resource found for the account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/opt-outs/bulk-assign:
    post:
      tags:
      - High Volume SMS
      operationId: addA2PSMSOptOuts
      description: 'Adds multiple opt-outs and/or opt-ins for the specified sender number and a set of recipient numbers.

        '
      summary: Add Opt-In/Out Numbers
      parameters:
      - $ref: '#/components/parameters/AccountId'
      requestBody:
        description: 'Consists of `from` field and `optOuts` and `optIns` lists.

          Both `optOuts` and `optIns` can be empty but not simultaneously - at least one of the lists must be entered.

          '
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OptOutBulkAssignRequest'
      responses:
        '200':
          description: The results of adding opt-outs and opt-ins.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OptOutBulkAssignResponse'
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [from] value is invalid.
                CMN-104:
                  value:
                    errorCode: CMN-104
                    message: Cannot parse request
        '500':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/batches:
    post:
      tags:
      - High Volume SMS
      summary: Send A2P SMS
      description: 'Allows to send high volume of A2P (Application-to-Person) SMS messages

        (in message batches). Only phone number with the `A2PSmsSender` feature can

        be used as a sender.

        '
      operationId: createA2PSMS
      parameters:
      - $ref: '#/components/parameters/AccountId'
      requestBody:
        description: SMS batch payload
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MessageBatchCreateRequest'
      responses:
        '201':
          description: Message batch created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageBatchResponse'
        '400':
          description: Validation Failed, Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-104:
                  value:
                    errorCode: CMN-104
                    message: Cannot parse request
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-request-max-body-size: 50m
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
    get:
      tags:
      - High Volume SMS
      summary: List A2P SMS Batches
      description: 'Returns the list of A2P batches sent from the current account.

        The list can be filtered by message batch ID and/or from phone number.

        '
      operationId: listA2PBatches
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/SmsDateFrom'
      - $ref: '#/components/parameters/SmsDateTo'
      - name: from
        in: query
        required: false
        description: Phone number in E.164 format from which the messages are going to be sent
        schema:
          type: string
        example: '15551234455'
      - name: status
        in: query
        required: false
        style: form
        explode: true
        description: A list of batch statuses to filter the results
        schema:
          type: array
          items:
            type: string
            enum:
            - Queued
            - Processing
            - Sent
            - Completed
        example:
        - Queued
        - Processing
      - name: pageToken
        in: query
        required: false
        description: The page token of the page to be retrieved
        schema:
          type: string
        example: pgt1
      - name: perPage
        in: query
        required: false
        description: The number of records to be returned per page
        schema:
          type: integer
          format: int64
        example: 1
      responses:
        '200':
          description: 'The list of batches sent by the account and filtered by the criteria specified in the query parameters

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchListResponse'
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: No resource found for the account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-request-max-body-size: 50m
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
  /restapi/v1.0/account/{accountId}/a2p-sms/batches/{batchId}:
    get:
      tags:
      - High Volume SMS
      summary: Get A2P SMS Batch
      description: Returns information on a message batch.
      operationId: readA2PBatch
      parameters:
      - $ref: '#/components/parameters/AccountId'
      - $ref: '#/components/parameters/BatchId'
      responses:
        '200':
          description: Message batch information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageBatchResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              examples:
                CMN-101:
                  value:
                    errorCode: CMN-101
                    message: Parameter [${parameterName}] value is invalid.
                CMN-110:
                  value:
                    errorCode: CMN-110
                    message: Header ${parameterName} should be specified
                CMN-407:
                  value:
                    errorCode: CMN-407
                    message: Parameter in header is invalid
        '401':
          description: Unauthorized error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
        '404':
          description: The batch is not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-102
                message: Resource for parameter [${parameterName}] is not found.
        '500':
          description: Service is unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ASGErrorResponse'
              example:
                errorCode: CMN-203
                message: Internal Server Error
      x-feature: SMSSending
      x-throttling-group: Light
      x-availability: High
      x-app-permission: A2PSMS
components:
  parameters:
    QueryBatchId:
      name: batchId
      in: query
      required: false
      description: Internal identifier of a message batch to filter the response
      example: '55577'
      schema:
        type: string
    AccountId:
      name: accountId
      in: path
      description: 'Internal identifier of the RingCentral account

        (can be set to "~" to indicate that the account associated with current authorization session should be used)

        '
      required: true
      style: simple
      explode: false
      schema:
        type: string
        default: '~'
      example: '~'
    SmsDateFrom:
      name: dateFrom
      in: query
      required: false
      description: The end of the time range to filter the results in ISO 8601 format including timezone. Default is the 'dateTo' minus 24 hours
      schema:
        type: string
        format: date-time
      example: '2020-11-09T16:07:52.597Z'
    SmsDirection:
      name: direction
      in: query
      required: false
      description: 'Direction of a message to filter the message list result.

        By default, there is no filter applied - both Inbound and Outbound messages are returned

        '
      schema:
        $ref: '#/components/schemas/SmsDirectionEnum'
      example: Inbound
    BatchId:
      name: batchId
      in: path
      required: true
      description: Internal identifier of a message batch to be retrieved
      example: '55577'
      schema:
        type: string
    SmsDateTo:
      name: dateTo
      in: query
      required: false
      description: The end of the time range to filter the results in ISO 8601 format including timezone. Default is the current time
      schema:
        type: string
        format: date-time
      example: '2020-11-25T16:07:52.597Z'
  schemas:
    MessageBatchCreateRequest:
      required:
      - from
      - messages
      type: object
      description: 'Batch of A2P SMS messages. This object provides specification to

        send message(s) to many recipients. It contains top-level attributes, such

        as `text` which apply to all `messages`. In addition to that, it is possible

        to override this attribute for each message. This way a single API call may

        be used to send individual messages to many recipients.

        '
      properties:
        from:
          type: string
          description: Sender's phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) format.
          example: '+15551234567'
        text:
          type: string
          description: Text to send to `messages.to` phone numbers. Can be overridden on a per-message basis
          example: Hello, World!
        messages:
          type: array
          description: Individual messages
          items:
            $ref: '#/components/schemas/MessageCreateRequest'
    OptOutBulkAssignResponse:
      type: object
      description: The results of adding opt-outs and opt-ins
      properties:
        optIns:
          type: object
          description: Contains successful and failed opt-ins
          properties:
            successful:
              type: array
              description: Recipients' phone numbers which opt-ins were successfully added for.
              items:
                type: string
              example:
              - '+15551237799'
            failed:
              type: array
              description: Recipients' phone numbers which opt-ins were failed to be added for. Plus, error messages
              items:
                $ref: '#/components/schemas/OptOutBulkAssignFailedEntry'
              example:
              - to: '+15551237798'
                errorMessage: Unexpected issue on removing an opt-out from bulk-assign request
        optOuts:
          type: object
          description: Contains successful and failed opt-outs
          properties:
            successful:
              type: array
              description: Recipients' phone numbers which opt-outs were successfully added for.
              items:
                type: string
              example:
              - '+15551237755'
            failed:
              type: array
              description: Recipients' phone numbers which opt-outs were failed to be added for. Plus, error messages
              items:
                $ref: '#/components/schemas/OptOutBulkAssignFailedEntry'
              example:
              - to: '+15551237756'
                errorMessage: Unexpected issue on creating an opt-out from bulk-assign request
    MessageStatusesResponse:
      type: object
      description: The messages status object with details of each status
      properties:
        queued:
          $ref: '#/components/schemas/MessageStatusCounts'
        delivered:
          $ref: '#/components/schemas/MessageStatusCounts'
        deliveryFailed:
          $ref: '#/components/schemas/MessageStatusCounts'
        sent:
          $ref: '#/components/schemas/MessageStatusCounts'
        sendingFailed:
          $ref: '#/components/schemas/MessageStatusCounts'
    SmsStatusEnum:
      type: string
      description: Current status of a message
      example: Queued
      enum:
      - Queued
      - Delivered
      - Sent
      - SendingFailed
      - DeliveryFailed
    MessageStatusCounts:
      type: object
      description: Message status parameters
      properties:
        cost:
          type: number
          format: float
          description: Total cost of all messages with this status code
        count:
          type: integer
          description: Count of messages with this status code
          format: int32
          example: 7
        errorCodeCounts:
          type: object
          description: Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources
          additionalProperties:
            type: integer
            description: Count of messages with this error code
            format: int32
            example: 5
    PagingResource:
      type: object
      description: Pagination details
      properties:
        pageToken:
          type: string
          description: Page token of the current response list
          example: pgt1
        perPage:
          type: integer
          format: int32
          description: Number of records per page
          example: 3
        firstPageToken:
          type: string
          description: First page token of the current filter criteria
          example: fpgt1
        previousPageToken:
          type: string
          description: Previous page token of the current filter criteria
          example: lpgt1
        nextPageToken:
          type: string
          description: Next page token of the current filter criteria
          example: npgt1
    ASGErrorResponse:
      type: object
      description: Error response
      required:
      - errorCode
      - message
      properties:
        errorCode:
          type: string
          description: Error code
          example: CMN-101
        message:
          type: string
          description: Human-readable description of the error. Not suitable for end users.
          example: AccountId 1234 is invalid
    SmsDirectionEnum:
      type: string
      description: Direction of the SMS message
      enum:
      - Inbound
      - Outbound
    OptOutBulkAssignRequest:
      type: object
      description: Consists of `from` field and `optOuts` and `optIns` lists. Both `optOuts` and `optIns` can be empty but not simultaneously - at least one of the lists must be entered."
      required:
      - from
      properties:
        from:
          type: string
          description: The phone number of a sender which the recipients should be opted out from or opted in to
          example: '+15551234455'
        optOuts:
          type: array
          description: The list of phone numbers to be opted out
          items:
            type: string
          example:
          - '+15551237755'
          - '+15551237756'
        optIns:
          type: array
          description: The list of phone numbers to be opted in
          items:
            type: string
          example:
          - '+15551237799'
          - '+15551237798'
    OptOutBulkAssignFailedEntry:
      type: object
      description: Represents a failure of adding opt-out / opt-in. A pair of a recipient phone number and an error message
      properties:
        to:
          type: string
          description: A recipient phone number
          example: '+15551237756'
        errorMessage:
          type: string
          description: An error happened on adding opt-out / opt-in
          example: Unexpected issue on creating an opt-out from bulk-assign request
    MessageCreateRequest:
      type: object
      description: Single individual SMS resource
      required:
      - to
      properties:
        to:
          type: array
          items:
            type: string
          description: 'List of phone numbers in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I)

            format, recipients of this message. Currently only one number is supported

 

# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ringcentral/refs/heads/main/openapi/ringcentral-high-volume-sms-api-openapi.yml