We hebben de Kinsta API uitgebreid met nieuwe mogelijkheden voor beheer van domein en gebruikers, waardoor teams nog meer controle krijgen over hun omgevingen, zonder dat ze hoeven in te loggen op MyKinsta.

Met deze updates kun je nu programmatisch het primaire domein van een WordPress omgeving wijzigen en extra SFTP accounts volledig beheren via de Kinsta API.

Het primaire domein van een omgeving wijzigen

Voorheen kon je met de Kinsta API domeinentoevoegen aan of verwijderen uit je site, wat geweldig was voor het instellen en opschonen. Maar je kon niet wijzigen welk domein als primair was ingesteld voor een omgeving.

Met deze nieuwe release kun je nu een bestaand domein instellen als het nieuwe primaire domein voor een specifieke omgeving met behulp van het volgende endpoint:

PUT /sites/environments/{env_id}/change-primary-domain

Om het endpoint te gebruiken, heb je de domain_id nodig van het domein dat je als primair wilt instellen. Dit moet een van de domeinen zijn die al aan de omgeving zijn gekoppeld.

Je kunt de domain_id vinden met de Get Site by ID of Get Site Environments eindpunten. Het ziet er ongeveer zo uit in het antwoord:

"domains": [
  {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "name": "example.com",
    "type": "live"
  }
]

Je moet ook het veld run_search_and_replace instellen. Als dit is ingesteld op true, wordt een zoek- en vervangactie gestart in de database van de site om URL’s bij te werken die naar het domein verwijzen.

Hier is een voorbeeld met curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/change-primary-domain' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain_id": "your-domain-id",
    "run_search_and_replace": true
  }'

Volledige ondersteuning voor het beheren van extra SFTP accounts

In april hebben we de mogelijkheid toegevoegd om meerdere SFTP gebruikersaccounts rechtstreeks in het MyKinsta dashboard aan te maken en te beheren. Nu kun je dat allemaal doen met behulp van de Kinsta API.

Dit geeft je volledige programmatische controle over extra SFTP gebruikers in elke omgeving. Je kunt toegang inschakelen, nieuwe gebruikers toevoegen, een lijst maken van bestaande gebruikers of ze helemaal verwijderen.

Toegang in- of uitschakelen

Voordat je gebruikers toevoegt, moet extra SFTP toegang worden ingeschakeld voor de omgeving. Je kunt dat doen met:

PUT /sites/environments/{env_id}/additional-sftp-accounts/toggle-status

Hier is een voorbeeld met curl:

curl -i -X PUT \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts/toggle-status' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true
  }'

Dit kan op elk moment worden teruggedraaid door "enabled": false in te stellen.

Een nieuwe SFTP gebruiker toevoegen

Eenmaal ingeschakeld, kun je gebruikers toevoegen met dit endpoint:

POST /sites/environments/{env_id}/additional-sftp-accounts

Met het verzoek kun je een gebruikersnaam, veilig wachtwoord (minimaal 16 tekens), hoofdmap en toestemmingsniveau (read of write) instellen.

curl -i -X POST \
  'https://api.kinsta.com/v2/sites/environments/{env_id}/additional-sftp-accounts' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "username": "dev-user",
    "password": "R8zXwT@#bV!kJq9^",
    "root_directory": "/wp-content/themes",
    "permission": "write"
  }'

Dit zijn in feite dezelfde controls die je zou vinden in MyKinsta, inclusief de mogelijkheid om de toegang tot specifieke mappen te beperken of alleen-lezen rechten toe te kennen.

Gebruikers weergeven en verwijderen

Je kunt op deze manier een lijst van extra SFTP accounts opvragen:

GET /sites/environments/{env_id}/additional-sftp-accounts

Om er een te verwijderen:

DELETE /sites/environments/additional-sftp-accounts/{sftp_account_id}

Dit geeft je volledige flexibiliteit om accountrotatie te automatiseren, beperkte toegang te verlenen aan medewerkers of referenties in te trekken na een implementatie.

Nieuwe metagegevens in omgevingsoverzichten

Om deze nieuwe mogelijkheden te ondersteunen, hebben we het veld is_additional_sftp_accounts_enabled toegevoegd aan de volgende endpoints:

Dit maakt het eenvoudiger om te controleren voor welke omgevingen extra SFTP toegang is ingeschakeld, vooral als je er veel beheert voor je platform of klantaccounts.

Meer controle voor moderne teams

Deze nieuwe API functies geven je meer controle over je infrastructuur, of je nu testomgeving-workflows automatiseert, SFTP credentials roteert of site URL’s programmatisch wijzigt.

Je kunt alle request/response details vinden in de Kinsta API documentatie. Je kunt veel doen met de Kinsta API en veel bureaus en ontwikkelaars vertrouwen er al op om honderden sites efficiënt te beheren.

Klaar om te beginnen? Ga naar MyKinsta om je API token te genereren en te beginnen met bouwen.