Identity Delegation Configs

Delegation configs define the default policy for sub-delegation behavior and delegation depth.

Identity Delegation Configs object

Attributes

object

String

String representing the object's type

id

String

Unique delegation config identifier.

status

Enum

Current lifecycle status of the delegation config.

is_default

Boolean

Whether this config is the default config for the environment.

name

StringNullable

Human-readable name of the delegation config.

description

StringNullable

Optional description of the delegation policy.

metadata

ObjectNullable

Additional metadata associated with the delegation config.

sub_delegation_behavior

Enum

How this config handles sub-delegation requests.

sub_delegation_depth

Number

Maximum allowed sub-delegation depth for this policy.

created_at

Date

Timestamp when the delegation config was created.

updated_at

Date

Timestamp when the delegation config was last updated.

{
  "object": "identity.delegation_config",
  "id": "idc_2mNpQrStUvWxYzAb",
  "status": "active",
  "name": "Default External Sharing Policy",
  "description": "Allows one level of reviewed sub-delegation",
  "metadata": {},
  "sub_delegation_behavior": "allow",
  "sub_delegation_depth": 1,
  "created_at": "2026-02-03T10:15:00.000Z",
  "updated_at": "2026-02-10T14:30:00.000Z"
}

List identity delegation configs

Returns a paginated list of identity delegation configs.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

Filter configs by name or description.

status

UnionOptional

Filter by one or more config statuses.

id

UnionOptional

Filter by config ID or IDs.

created_at

ObjectOptional

Filter identity delegation config creation time by date range

updated_at

ObjectOptional

Filter identity delegation config last update time by date range

GEThttp://api.metorial.com/identity-delegation-configs
curl -X GET "https://api.metorial.com/identity-delegation-configs" \
  -H "Authorization: Bearer metorial_sk_..."

Get identity delegation config

Retrieves a specific identity delegation config by ID.

URL Parameters

identity_delegation_config_id

String

The unique identifier for the identity_delegation_config

GEThttp://api.metorial.com/identity-delegation-configs/:identity_delegation_config_id
curl -X GET "https://api.metorial.com/identity-delegation-configs/ide_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create identity delegation config

Creates a new identity delegation config.

Request Body

name

StringOptional

Optional display name for the delegation config.

description

StringOptional

Optional description of the delegation policy.

metadata

ObjectOptional

Additional metadata to store on the delegation config.

sub_delegation_behavior

Enum

How sub-delegations should be handled.

sub_delegation_depth

NumberOptional

Maximum allowed sub-delegation depth.

POSThttp://api.metorial.com/identity-delegation-configs
curl -X POST "https://api.metorial.com/identity-delegation-configs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "sub_delegation_behavior": "allow",
  "sub_delegation_depth": 0
}'

Update identity delegation config

Updates mutable fields on an existing identity delegation config.

URL Parameters

identity_delegation_config_id

String

The unique identifier for the identity_delegation_config

Request Body

name

StringOptional

Updated display name for the delegation config.

description

StringOptional

Updated description for the delegation config.

metadata

ObjectOptional

Updated metadata for the delegation config.

sub_delegation_behavior

EnumOptional

How sub-delegations should be handled.

sub_delegation_depth

NumberOptional

Maximum allowed sub-delegation depth.

PATCHhttp://api.metorial.com/identity-delegation-configs/:identity_delegation_config_id
curl -X PATCH "https://api.metorial.com/identity-delegation-configs/ide_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "sub_delegation_behavior": "allow",
  "sub_delegation_depth": 0
}'

Delete identity delegation config

Archives an identity delegation config.

URL Parameters

identity_delegation_config_id

String

The unique identifier for the identity_delegation_config

DELETEhttp://api.metorial.com/identity-delegation-configs/:identity_delegation_config_id
curl -X DELETE "https://api.metorial.com/identity-delegation-configs/ide_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."