Update IDP configuration | Crehana Developers

Partially updates the SAML2 IDP configuration. Only the fields included in the request body will be modified. Supports updating entity_id, name_id_format and is_active.

Authentication

Api-Keystring

API key of the organization. Always sent together with the Secret-Access header.

Path parameters

centralized_organization_slugstringRequired

Request

This endpoint expects an object.

entity_idstringOptional

Entity ID URI for the IDP

name_id_formatenumOptional

Name ID format for SAML assertions

is_activebooleanOptional

Whether the IDP configuration is active

Response

Successful Response

messagestring

Message of the response

datetimestring

Datetime of the API in ISO Format

dataobjectOptional

Errors

400

Bad Request Error

404

Not Found Error

422

Unprocessable Entity Error

$	curl -X PATCH https://qa.creha.co/api/v5/rest/auth/saml2/centralized_organization_slug/idp/ \
>	-H "Secret-Access: Secret-Access" \
>	-H "Api-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"message": "IDP configuration retrieved successfully",
3	"datetime": "2026-03-04T12:00:00",
4	"data": {
5	"id": "1",
6	"centralized_organization_id": "123",
7	"entity_id": "https://idp.crehana.com/saml2/org/123",
8	"certificate": "MIIDxTCCAq2gAwIBA...",
9	"certificate_expires_at": "2027-03-04T12:00:00Z",
10	"name_id_format": "email",
11	"is_active": true,
12	"created_at": "2026-03-04T12:00:00Z",
13	"updated_at": "2026-03-04T12:00:00Z"
14	}
15	}

Authentication

Path parameters

Headers

Request

Response

Errors