Twilio SendGrid Verified Senders API — Sender Verification

naftiko: 1.0.0-alpha2
info:
  label: Twilio SendGrid Verified Senders API — Sender Verification
  description: 'Twilio SendGrid Verified Senders API — Sender Verification. 8 operations. Lead operation: Create Verified
    Sender Request. Self-contained Naftiko capability covering one Sendgrid business surface.'
  tags:
  - Sendgrid
  - Sender Verification
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SENDGRID_API_KEY: SENDGRID_API_KEY
capability:
  consumes:
  - type: http
    namespace: tsg_verified_senders_v3-sender-verification
    baseUri: https://api.sendgrid.com
    description: Twilio SendGrid Verified Senders API — Sender Verification business capability. Self-contained, no shared
      references.
    resources:
    - name: v3-verified_senders
      path: /v3/verified_senders
      operations:
      - name: createverifiedsender
        method: POST
        description: Create Verified Sender Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: listverifiedsender
        method: GET
        description: Get All Verified Senders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: number
          description: Specifies the number of results to be returned by the API. This parameter can be used to limit the
            results returned or in combination with the `lastSeenID` para
        - name: lastSeenID
          in: query
          type: number
          description: 'Returns senders with an ID number occurring after the passed in ID. In other words, the `lastSeenID`
            provides a starting point from which SendGrid will iterate '
        - name: id
          in: query
          type: integer
          description: Returns information about only the Sender Identity passed in the request.
    - name: v3-verified_senders-domains
      path: /v3/verified_senders/domains
      operations:
      - name: listverifiedsenderdomain
        method: GET
        description: Domain Warn List
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-verified_senders-resend-id
      path: /v3/verified_senders/resend/{id}
      operations:
      - name: resendverifiedsender
        method: POST
        description: Resend Verified Sender Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-verified_senders-steps_completed
      path: /v3/verified_senders/steps_completed
      operations:
      - name: listverifiedsenderstepscompleted
        method: GET
        description: Completed Steps
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-verified_senders-verify-token
      path: /v3/verified_senders/verify/{token}
      operations:
      - name: verifysendertoken
        method: GET
        description: Verify Sender Request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v3-verified_senders-id
      path: /v3/verified_senders/{id}
      operations:
      - name: updateverifiedsender
        method: PATCH
        description: Edit Verified Sender
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteverifiedsender
        method: DELETE
        description: Delete Verified Sender
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.SENDGRID_API_KEY}}'
  exposes:
  - type: rest
    namespace: tsg_verified_senders_v3-sender-verification-rest
    port: 8080
    description: REST adapter for Twilio SendGrid Verified Senders API — Sender Verification. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/v3/verified-senders
      name: v3-verified-senders
      description: REST surface for v3-verified_senders.
      operations:
      - method: POST
        name: createverifiedsender
        description: Create Verified Sender Request
        call: tsg_verified_senders_v3-sender-verification.createverifiedsender
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listverifiedsender
        description: Get All Verified Senders
        call: tsg_verified_senders_v3-sender-verification.listverifiedsender
        with:
          limit: rest.limit
          lastSeenID: rest.lastSeenID
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/verified-senders/domains
      name: v3-verified-senders-domains
      description: REST surface for v3-verified_senders-domains.
      operations:
      - method: GET
        name: listverifiedsenderdomain
        description: Domain Warn List
        call: tsg_verified_senders_v3-sender-verification.listverifiedsenderdomain
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/verified-senders/resend/{id}
      name: v3-verified-senders-resend-id
      description: REST surface for v3-verified_senders-resend-id.
      operations:
      - method: POST
        name: resendverifiedsender
        description: Resend Verified Sender Request
        call: tsg_verified_senders_v3-sender-verification.resendverifiedsender
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/verified-senders/steps-completed
      name: v3-verified-senders-steps-completed
      description: REST surface for v3-verified_senders-steps_completed.
      operations:
      - method: GET
        name: listverifiedsenderstepscompleted
        description: Completed Steps
        call: tsg_verified_senders_v3-sender-verification.listverifiedsenderstepscompleted
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/verified-senders/verify/{token}
      name: v3-verified-senders-verify-token
      description: REST surface for v3-verified_senders-verify-token.
      operations:
      - method: GET
        name: verifysendertoken
        description: Verify Sender Request
        call: tsg_verified_senders_v3-sender-verification.verifysendertoken
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v3/verified-senders/{id}
      name: v3-verified-senders-id
      description: REST surface for v3-verified_senders-id.
      operations:
      - method: PATCH
        name: updateverifiedsender
        description: Edit Verified Sender
        call: tsg_verified_senders_v3-sender-verification.updateverifiedsender
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteverifiedsender
        description: Delete Verified Sender
        call: tsg_verified_senders_v3-sender-verification.deleteverifiedsender
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: tsg_verified_senders_v3-sender-verification-mcp
    port: 9090
    transport: http
    description: MCP adapter for Twilio SendGrid Verified Senders API — Sender Verification. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: create-verified-sender-request
      description: Create Verified Sender Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tsg_verified_senders_v3-sender-verification.createverifiedsender
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-all-verified-senders
      description: Get All Verified Senders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.listverifiedsender
      with:
        limit: tools.limit
        lastSeenID: tools.lastSeenID
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: domain-warn-list
      description: Domain Warn List
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.listverifiedsenderdomain
      outputParameters:
      - type: object
        mapping: $.
    - name: resend-verified-sender-request
      description: Resend Verified Sender Request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: tsg_verified_senders_v3-sender-verification.resendverifiedsender
      outputParameters:
      - type: object
        mapping: $.
    - name: completed-steps
      description: Completed Steps
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.listverifiedsenderstepscompleted
      outputParameters:
      - type: object
        mapping: $.
    - name: verify-sender-request
      description: Verify Sender Request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.verifysendertoken
      outputParameters:
      - type: object
        mapping: $.
    - name: edit-verified-sender
      description: Edit Verified Sender
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.updateverifiedsender
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-verified-sender
      description: Delete Verified Sender
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: tsg_verified_senders_v3-sender-verification.deleteverifiedsender
      outputParameters:
      - type: object
        mapping: $.