overlay: 1.0.0
info:
  title: API Evangelist enhancements for EmailOctopus Field API
  version: 1.0.0
extends: openapi/emailoctopus-field-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: openapi/emailoctopus-field-api-openapi.yml + repo artifacts
actions:
- target: $.info
  update:
    x-apievangelist-provider: emailoctopus
    x-apievangelist-artifacts:
      authentication: authentication/emailoctopus-authentication.yml
      conventions: conventions/emailoctopus-conventions.yml
      errors: errors/emailoctopus-problem-types.yml
      rate-limits: rate-limits/emailoctopus-rate-limits.yml
      data-model: data-model/emailoctopus-data-model.yml
      webhooks: asyncapi/emailoctopus-webhooks.yml
      lifecycle: lifecycle/emailoctopus-lifecycle.yml
    x-apievangelist-harvest:
      source: https://emailoctopus.com/api-documentation/v2
      fetched: '2026-08-13'
      note: Split by tag from the provider-published OpenAPI 3.1.0; operationIds are the provider's own.
    contact:
      name: EmailOctopus Support
      url: https://help.emailoctopus.com
    termsOfService: https://emailoctopus.com/legal/terms
- target: $.info
  update:
    x-apievangelist-conventions:
      pagination:
        style: cursor
        params:
        - limit
        - starting_after
        max_page_size: 100
        collection_field: data
        cursor_field: paging.next.starting_after
      idempotency:
        supported: false
        note: No Idempotency-Key contract. PUT upserts are the only safe-retry path.
      errors:
        format: rfc7807
        media_type: application/json
        type_uri_prefix: https://emailoctopus.com/api-documentation/v2#
      rate_limit:
        algorithm: token-bucket
        bucket: 100
        refill_per_second: 10
        remaining_header: X-RateLimiting-Remaining
        retry_header: X-RateLimit-Retry-After
        exhausted_status: 429
- target: $.servers[0]
  update:
    description: EmailOctopus v2 production API. No version segment in the path; version is bound to the API key.
- target: $.paths['/lists/{list_id}/fields'].post
  update:
    x-apievangelist-operation-id: api_lists_list_idfields_post
    x-apievangelist-tag: Field
- target: $.paths['/lists/{list_id}/fields/{tag}'].put
  update:
    x-apievangelist-operation-id: api_lists_list_idfields_tag_put
    x-apievangelist-tag: Field
- target: $.paths['/lists/{list_id}/fields/{tag}'].delete
  update:
    x-apievangelist-operation-id: api_lists_list_idfields_tag_delete
    x-apievangelist-tag: Field