Twilio SendGrid Suppressions API — Invalid Emails

naftiko: 1.0.0-alpha2
info:
  label: Twilio SendGrid Suppressions API — Invalid Emails
  description: 'Twilio SendGrid Suppressions API — Invalid Emails. 4 operations. Lead operation: Retrieve all invalid emails.
    Self-contained Naftiko capability covering one Sendgrid business surface.'
  tags:
  - Sendgrid
  - Invalid Emails
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SENDGRID_API_KEY: SENDGRID_API_KEY
capability:
  consumes:
  - type: http
    namespace: tsg_suppressions_v3-invalid-emails
    baseUri: https://api.sendgrid.com
    description: Twilio SendGrid Suppressions API — Invalid Emails business capability. Self-contained, no shared references.
    resources:
    - name: v3-suppression-invalid_emails
      path: /v3/suppression/invalid_emails
      operations:
      - name: listinvalidemail
        method: GET
        description: Retrieve all invalid emails
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: start_time
          in: query
          type: integer
          description: Refers start of the time range in unix timestamp when an invalid email was created (inclusive).
        - name: end_time
          in: query
          type: integer
          description: Refers end of the time range in unix timestamp when an invalid email was created (inclusive).
        - name: email
          in: query
          type: string
          description: This parameter allows you to filter results by email address. Only invalid addresses matching an address
            passed in this parameter will be returned.
      - name: deleteinvalidemails
        method: DELETE
        description: Delete invalid emails
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: v3-suppression-invalid_emails-email
      path: /v3/suppression/invalid_emails/{email}
      operations:
      - name: getinvalidemail
        method: GET
        description: Retrieve a specific invalid email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: deleteinvalidemail
        method: DELETE
        description: Delete a specific invalid email
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.SENDGRID_API_KEY}}'
  exposes:
  - type: rest
    namespace: tsg_suppressions_v3-invalid-emails-rest
    port: 8080
    description: REST adapter for Twilio SendGrid Suppressions API — Invalid Emails. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/v3/suppression/invalid-emails
      name: v3-suppression-invalid-emails
      description: REST surface for v3-suppression-invalid_emails.
      operations:
      - method: GET
        name: listinvalidemail
        description: Retrieve all invalid emails
        call: tsg_suppressions_v3-invalid-emails.listinvalidemail
        with:
          start_time: rest.start_time
          end_time: rest.end_time
          email: rest.email
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteinvalidemails
        description: Delete invalid emails
        call: tsg_suppressions_v3-invalid-emails.deleteinvalidemails
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/suppression/invalid-emails/{email}
      name: v3-suppression-invalid-emails-email
      description: REST surface for v3-suppression-invalid_emails-email.
      operations:
      - method: GET
        name: getinvalidemail
        description: Retrieve a specific invalid email
        call: tsg_suppressions_v3-invalid-emails.getinvalidemail
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteinvalidemail
        description: Delete a specific invalid email
        call: tsg_suppressions_v3-invalid-emails.deleteinvalidemail
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: tsg_suppressions_v3-invalid-emails-mcp
    port: 9090
    transport: http
    description: MCP adapter for Twilio SendGrid Suppressions API — Invalid Emails. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: retrieve-all-invalid-emails
      description: Retrieve all invalid emails
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_suppressions_v3-invalid-emails.listinvalidemail
      with:
        start_time: tools.start_time
        end_time: tools.end_time
        email: tools.email
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-invalid-emails
      description: Delete invalid emails
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: tsg_suppressions_v3-invalid-emails.deleteinvalidemails
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieve-specific-invalid-email
      description: Retrieve a specific invalid email
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_suppressions_v3-invalid-emails.getinvalidemail
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-specific-invalid-email
      description: Delete a specific invalid email
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: tsg_suppressions_v3-invalid-emails.deleteinvalidemail
      outputParameters:
      - type: object
        mapping: $.