---
title: "Update an Identity Federation app"
method: PATCH
path: "/api/v1/identity-federation"
tags: ["Identity Federation"]
---

# Update an Identity Federation app

`PATCH /api/v1/identity-federation`

## Request body

- IdentityFederationApp
  - `tenant` string — Tenant
  - `product` string — Product
  - `name` string — Name
  - `acsUrl` string — ACS URL
  - `entityId` string — Entity ID
  - `logoUrl` string — Logo URL
  - `faviconUrl` string — Favicon URL
  - `primaryColor` string — Primary color
  - `tenants` string[] — Mapping of tenants whose connections will be grouped under this Identity Federation app
  - `mappings` AttributeMapping[] — Mapping of attributes from the IdP to SP
    - `key` string — SP attribute
    - `value` string — IdP attribute
  - `type` string[] — If creating an OIDC app, this should be set to 'oidc' otherwise it defaults to 'saml'
  - `redirectUrl` string[] — If creating an OIDC app, provide the redirect URL
  - `samlAudienceOverride` string — Override the SAML Audience on a per app basis
  - `includeOidcTokensInAssertion` boolean — Include OIDC tokens in the SAML assertion
  - `ttlInMinutes` number — Time-to-live in minutes for the SAML assertion, does not apply to OIDC flows
  - `id` string, required — App ID

## Response `200`

Success

- IdentityFederationResponse
  - `data` IdentityFederationApp
    - `tenant` string — Tenant
    - `product` string — Product
    - `name` string — Name
    - `acsUrl` string — ACS URL
    - `entityId` string — Entity ID
    - `logoUrl` string — Logo URL
    - `faviconUrl` string — Favicon URL
    - `primaryColor` string — Primary color
    - `tenants` string[] — Mapping of tenants whose connections will be grouped under this Identity Federation app
    - `mappings` AttributeMapping[] — Mapping of attributes from the IdP to SP
      - `key` string — SP attribute
      - `value` string — IdP attribute
    - `type` string[] — If creating an OIDC app, this should be set to 'oidc' otherwise it defaults to 'saml'
    - `redirectUrl` string[] — If creating an OIDC app, provide the redirect URL
    - `samlAudienceOverride` string — Override the SAML Audience on a per app basis
    - `includeOidcTokensInAssertion` boolean — Include OIDC tokens in the SAML assertion
    - `ttlInMinutes` number — Time-to-live in minutes for the SAML assertion, does not apply to OIDC flows
    - `id` string, required — App ID
  - `error` IdentityFederationError
    - `message` string

---

[API](https://skmtc.net/ory/apis/enterprise-sso-directory-sync.md) · [All operations](https://skmtc.net/ory/apis/enterprise-sso-directory-sync/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ory/enterprise-sso-directory-sync/versions/d92c991ace28/schema)