Skip to navigation
Requests & TicketsOther

createIgaAccessRequest

View as Markdown

Create an IGA access request.

Create an IGA access request (service request / SER) for an entitlement. If the target is an external ITSM and the user is not connected, returns 428 EXTERNAL_AUTH_REQUIRED with authorization_url; show it to the user and retry the same call after they connect.

Parameters

NameTypeRequiredDescription
requester_idintegerNoOptional. The user id this request is on behalf of (e.g. a manager filing for a report). Defaults to the authenticated c
entitlement_idintegerNoEntitlement ID to request access for
policy_idintegerNoPolicy ID governing the access request
business_justificationstringNoBusiness justification for the access request
selected_durationstringNoSelected access duration for TIME_BASED lifecycle policies. Format: “{value}_{UNIT}” where UNIT is HOURS, DAYS, or WEEKS
conversation_thread_idstringNoConversation thread ID for context tracking
parent_request_idstringNoDisplay ID of the ticket you are raising this access request from (e.g. “SER-123”) — set it whenever you are working on
item_fieldsobjectNoValues for the entitlement’s catalog item form fields, keyed by each field’s reference_key (from `getRequestFormFields