Update a partner
Changes a partner’s access, its validity window, its IP allowlist or its state. Every member is optional and anything you omit is left alone — but permissions and scope, when supplied, REPLACE the stored list wholesale. There is no per-entry merge, because a merge would make “remove the last ledger” impossible to express.
Called to widen or narrow a partner mid-life, and to suspend or reactivate one (state: "suspended" / "active"). Suspending is the reversible kill switch; deleting is not.
ipAllowlist has THREE meanings here and they are not interchangeable: omit the member to leave the list as it is, send null to go back to inheriting the organization’s list, send entries to replace it with the partner’s own. An empty array is refused.
validFrom and validUntil work the same way, one bound at a time: omit the member to keep the stored bound, send an RFC 3339 instant to set it, send null to remove it and leave the window open on that side (no start date: honoured from now on; no end date: never expires — a partner already past its end date is honoured again unless it is suspended). An empty string is refused with 422. When you send only one bound it is checked against the other one as stored: moving validFrom to or past the stored validUntil, or validUntil to or before the stored validFrom, is 400 IDE-1045 and nothing is written. To move a window to a later period, send both bounds in the same request.
What changes: the stored record, and with it every future authorization. The change takes effect on the next authorization decision, including for access tokens already issued to this partner. Token issuance is refused while the partner is suspended or outside its validity window, and from an address outside its IP allowlist; a permission or scope change does not stop issuance, it limits what the token can do. To cut a partner off, suspend it.
Failures: every code POST can return, applied to the record as it will be after the patch (IDE-1042, IDE-1043, IDE-1044, IDE-1045, IDE-1047, IDE-1048, IDE-0036, IDE-1050, IDE-1052, 409 IDE-1040), plus:
400 IDE-1054— the product is not ready for partners yet: it has not published a scope catalog. Raised only when the request sendspermissions: a partner that already holds such a line can still be suspended, reactivated or renamed, and the line can be removed.400 IDE-1055— a permission names a product that has not opted in to partners. Like IDE-1054 it is raised only when the request sendspermissions, for every line; remove the line to proceed.400 IDE-1056is checked when eitherpermissionsorscopechanges: granting a write and narrowing the scope under a write already granted both put the write above the scope. Narrow the scope and drop the write in the same update.404 IDE-1046— no such partner in your organization.403— your token does not hold thepartnersresource.503 IDE-0066— the identity provider is unavailable (unreachable, too slow to answer, or failing). Nothing about the request was wrong; retry it later.
Parámetros de ruta
Cuerpo
The members to change. Anything omitted is left as it is.
New window start (RFC 3339). Omit to keep the stored start; send null to remove it, so the partner's credentials are honoured from now on; an empty string is refused (422). The resulting window is checked against the stored validUntil when that is not sent: validUntil must stay later than validFrom, else 400 IDE-1045.
"2026-01-01T00:00:00Z"
New window end (RFC 3339). Omit to keep the stored end; send null to remove it, so the window has no end date and a partner already past its end date is honoured again (unless suspended); an empty string is refused (422). Must be later than validFrom — the one sent, or the stored one when validFrom is not sent — else 400 IDE-1045.
"2027-01-01T00:00:00Z"
Respuesta
OK

