Zendesk Sell · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Zendesk Sell contacts api

11 actions 11 updates update extends openapi/zendesk-sell-contacts-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Zendesk Sell's API. It is a proposal applied on top of the contract, not a document Zendesk Sell publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-agentic-access-refx-apievangelist-enrichedx-lifecycle-statusx-end-of-lifex-end-of-life-sourcex-artifactsx-rate-limitx-required-headers

Targets 7

$.info

$.paths['/v2/contacts'].get

$.paths['/v2/contacts'].post

$.paths['/v2/contacts/{id}'].get

$.paths['/v2/contacts/{id}'].put

$.paths['/v2/contacts/{id}'].delete

$.paths['/v2/contacts/upsert'].post

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Zendesk Sell contacts api
  version: 1.0.0
extends: openapi/zendesk-sell-contacts-api-openapi.yml
x-generated: '2026-08-13'
x-method: generated
x-source: >-
  Enhancements derived from the Zendesk Sell developer documentation (requests, errors,
  authentication, rate-limits, retirement announcement) captured in this repo. The original
  OpenAPI is never mutated.
actions:
- target: $.info
  update:
    x-apievangelist-enriched: '2026-08-13'
    x-lifecycle-status: retiring
    x-end-of-life: '2027-08-31'
    x-end-of-life-source: https://support.zendesk.com/hc/en-us/articles/9591462550042-Announcing-the-retiring-of-Zendesk-Sell
    x-artifacts:
      conventions: conventions/zendesk-sell-conventions.yml
      errors: errors/zendesk-sell-problem-types.yml
      rate-limits: rate-limits/zendesk-sell-rate-limits.yml
      authentication: authentication/zendesk-sell-authentication.yml
      scopes: scopes/zendesk-sell-scopes.yml
      data-model: data-model/zendesk-sell-data-model.yml
      events: events/zendesk-sell-events.yml
- target: $.info
  update:
    x-rate-limit:
      scope: per-token
      limit: 36000
      window: 1h
      status_on_exhaustion: 429
      headers: []
      source: https://developer.zendesk.com/api-reference/sales-crm/rate-limits/
- target: $.info
  update:
    x-required-headers:
    - name: User-Agent
      required: true
      note: Requests without a User-Agent are rejected with 400 invalid_user_agent.
      source: https://developer.zendesk.com/api-reference/sales-crm/requests/
- target: $.info
  update:
    x-error-envelope:
      problem_json: false
      shape: '{"errors":[{"error":{"code","message","details","resource","field"}}],"meta":{"http_status","logref"}}'
      request_id_field: meta.logref
      request_id_header: X-Request-Id
      source: https://developer.zendesk.com/api-reference/sales-crm/errors/
- target: $.info
  update:
    x-idempotency:
      supported: false
      note: >-
        No Idempotency-Key contract is published. The upsert operations match on
        caller-supplied business attributes; they are not replay-safe on a key.
- target: $.paths['/v2/contacts'].get
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#listContacts
- target: $.paths['/v2/contacts'].post
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#createContact
- target: $.paths['/v2/contacts/{id}'].get
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#getContact
- target: $.paths['/v2/contacts/{id}'].put
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#updateContact
- target: $.paths['/v2/contacts/{id}'].delete
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#deleteContact
- target: $.paths['/v2/contacts/upsert'].post
  update:
    x-agentic-access-ref: agentic-access/zendesk-sell-agentic-access.yml#upsertContact