POST/api/v1/s2s/providers/{providerId}/specialties

Attach provider specialty

Published Partner endpoint from the stable OpenAPI 1.0.0 contract.

Overview

Use this endpoint only with a Partner API key. Code samples use placeholders and the public sandbox URL.

Method: POST
Endpoint: /api/v1/s2s/providers/{providerId}/specialties
Authentication: X-API-Key

Request

Parameters

providerIdstring (uuid)pathRequired: Provider identifier.; Example: 5cd4f03b-5c1d-406e-b834-35b4f635c1c3
X-Correlation-IDstringheader: Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.; Example: 33333333-3333-4333-8333-333333333333

Request body

Required

specialtySlugstring: Specialty slug to attach to the provider.; Example: adipositas
specialtySlugsarray: Specialty slugs to attach to the provider in one request.; Example: ["adipositas","diabetes"]

Contract

The versioned OpenAPI contract is the authoritative source for parameters, request bodies, and response schemas.

Version

1.0.0

Expected response

201 Created

Download OpenAPI 1.0.0

Simulated sandbox

Language

cURL

curl --request POST \
  --url https://sandbox.arztkonsultation.io/api/v1/s2s/providers/example-providerId/specialties \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: {PARTNER_API_KEY}' \
  --data '{"specialtySlug":"adipositas","specialtySlugs":["adipositas","diabetes"]}'

Response scenario