Socotra

Socotra Producers API

The Producers API from Socotra — 31 operation(s) for producers.

GitHub OpenAPI

Operations 39

GET /producers/{tenantLocator}/producers/{producerLocator} #
PUT /producers/{tenantLocator}/producers/{producerLocator} #
PATCH /producers/{tenantLocator}/producers/{producerLocator} #
GET /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} #
PUT /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator} #
GET /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} #
PUT /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator} #
GET /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} #
PUT /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator} #
POST /producers/{tenantLocator}/producers #
POST /producers/{tenantLocator}/producers/{producerLocator}/licenses #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set #
POST /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate #
POST /producers/{tenantLocator}/producers/{producerLocator}/appointments #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/validate #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/unsuspend #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/suspend #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/retire #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/discard #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate #
PATCH /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard #
GET /producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy #
GET /producers/{tenantLocator}/producers/{producerLocator}/licenses/list #
GET /producers/{tenantLocator}/producers/{producerLocator}/codes/list #
GET /producers/{tenantLocator}/producers/{producerLocator}/appointments/list #
GET /producers/{tenantLocator}/producers/list #
GET /producers/{tenantLocator}/producers/codes/{code} #
GET /producers/events #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-producers-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/socotra-producers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

socotra-producers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Socotra Insurance Suite OpenAPI Definition Producers API
  description: Socotra Insurance Suite API
  termsOfService: https://www.socotra.com
  version: v0
servers:
- url: /
  description: Generated server url
tags:
- name: Producers
paths:
  /producers/{tenantLocator}/producers/{producerLocator}:
    get:
      operationId: fetchProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Producers
    put:
      operationId: replaceProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
    patch:
      operationId: updateProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}:
    get:
      operationId: fetchProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerLicenseLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Producers
    put:
      operationId: replaceProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerLicenseLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerLicenseReplaceRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
    patch:
      operationId: updateProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerLicenseLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerLicenseUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}:
    get:
      operationId: fetchProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Producers
    put:
      operationId: replaceProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerCodeReplaceRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
    patch:
      operationId: updateProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerCodeUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}:
    get:
      operationId: fetchProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerAppointmentLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Producers
    put:
      operationId: replaceProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerAppointmentLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerAppointmentReplaceRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
    patch:
      operationId: updateProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerAppointmentLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerAppointmentUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers:
    post:
      operationId: createProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/licenses:
    post:
      operationId: createProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerLicenseCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes:
    post:
      operationId: createProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerCodeCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/set:
    post:
      operationId: setCodeByNumber
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: code
        in: query
        required: true
        schema:
          type: string
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/number/generate:
    post:
      operationId: generateCodeByNumber
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/appointments:
    post:
      operationId: createProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProducerAppointmentCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/validate:
    patch:
      operationId: validateProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/unsuspend:
    patch:
      operationId: unsuspendProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/suspend:
    patch:
      operationId: suspendProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/retire:
    patch:
      operationId: retireProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/validate:
    patch:
      operationId: validateProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerLicenseLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/licenses/{producerLicenseLocator}/discard:
    patch:
      operationId: discardProducerLicense
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerLicenseLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerLicenseResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/discard:
    patch:
      operationId: discardProducer
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/validate:
    patch:
      operationId: validateProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/unsuspend:
    patch:
      operationId: unsuspendProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/suspend:
    patch:
      operationId: suspendProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/retire:
    patch:
      operationId: retireProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/codes/{producerCodeLocator}/discard:
    patch:
      operationId: discardProducerCode
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerCodeLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerCodeResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/validate:
    patch:
      operationId: validateProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerAppointmentLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/appointments/{producerAppointmentLocator}/discard:
    patch:
      operationId: discardProducerAppointment
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: producerAppointmentLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerAppointmentResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{producerLocator}/producerHierarchy:
    get:
      operationId: fetchProducerHierarchy
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: producerLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProducerHierarchyResponse'
                deprecated: false
      x-securityGroup: producers
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Producers
  /producers/{tenantLocator}/producers/{pr

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-producers-api-openapi.yml