curl --silent --show-error --fail-with-body --request PUT \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/connection' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"admin_token": "YOUR_API_KEY",
"api_version": "2026-08-01",
"shop_domain": "string"
}'
{
"adapter": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"metadata": {},
"updated_at": "2026-08-31T14:22:05Z",
"updated_by": "string"
}
Stores (or rotates) this workspace's credentials for a live adapter…
Connection saved; metadata only
PUT
/
v1
/
adapters
/
{name}
/
connection
curl --silent --show-error --fail-with-body --request PUT \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/connection' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"admin_token": "YOUR_API_KEY",
"api_version": "2026-08-01",
"shop_domain": "string"
}'
{
"adapter": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"metadata": {},
"updated_at": "2026-08-31T14:22:05Z",
"updated_by": "string"
}
Path parameters
string
required
Live adapter name (shopify or netsuite)
Request body
AdapterConnectionInput
string
required
Custom-app Admin API access token (
shpat_…). Write-only.string,null
Admin API version,
YYYY-MM; defaults to the platform default.string
required
{shop}.myshopify.com.Response
AdapterConnectionView
string
required
string (date-time)
required
string
required
object
required
Non-secret connection facts (shop domain, API version, account id, RESTlet host, auth type).
string (date-time)
required
string
required
Status codes
| Code | Meaning |
|---|---|
200 | Connection saved; metadata only |
403 | Organization administrator required |
422 | Invalid input, non-HTTPS / non-vendor host, or storage not enabled |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request PUT \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/connection' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--header 'Content-Type: application/json' \
--data '{
"admin_token": "YOUR_API_KEY",
"api_version": "2026-08-01",
"shop_domain": "string"
}'
{
"adapter": "string",
"created_at": "2026-08-31T14:22:05Z",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"metadata": {},
"updated_at": "2026-08-31T14:22:05Z",
"updated_by": "string"
}
Last modified on October 20, 2026