{"items":[{"type":"link","label":"Access Requests - V1","link":"/iga/openapi/governance-production-requests-admin-v1-reference","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference","content":{"contentType":"overview","meta":{"name":"Access Requests - V1"},"children":[{"nodeType":"container","panels":[{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"java","title":"Java","lang":"Java"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"go","title":"Go","lang":"Go"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com","description":"The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains."}}}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Access Requests - V1","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"Allows customers to easily access the Okta API"}],"sectionId":"/iga/openapi/governance-production-requests-admin-v1-reference"},{"nodeType":"external-docs","url":"https://developer.okta.com/docs/reference/core-okta-api/#design-principles","description":"Find more info here"}],"sectionId":"/iga/openapi/governance-production-requests-admin-v1-reference"}]}]}},{"type":"group","label":"Request Types","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types","items":[{"label":"Create a request type","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/createrequesttype","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/createrequesttype","metadata":{"seo":{"title":"Create a request type","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createRequestType","name":"Create a request type","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a request type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a request type that governs the requests allowed in your org."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specify the following to create a request type:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What resource access can be requested"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Who can request access"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What question(s) requesters must answer (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Who can approve access"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What question(s) approvers must answer (optional)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long access should be granted for (optional)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can have a maximum of 100 combined items across "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approvalSettings.approvals"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approvalSettings.approvals.approverFields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestSettings.requesterFields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" objects for each request type. This translates to a maximum of 100 combined questions, tasks, or actions for each request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The limit on the JSON response payload of a request type is 100,000 characters."},"children":[]}]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-type-creatable","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"]}},"schemaId":"components/schemas/request-type-creatable","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"],"pointer":"/paths/~1governance~1api~1v1~1request-types/post/requestBody","description":"The writable attributes of a request type"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/governance/api/v1/request-types","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/request-type-creatable","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"]}},"responseCodes":["201","400","401","403","429","500"],"pointer":"/governance/api/v1/request-types","href":"request-types/createrequesttype","openApiOperationId":"createRequestType","summary":"Create a request type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/request-type-creatable","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-type-creatable","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"]}},"examples":[{},{},{},{},{},{},{},{},{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"A successful request type create response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"]}},"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"],"headers":{"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1416"},{"code":"400","description":"An invalid request to create a request type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization.","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization.","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing"]},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"]}}},{"code":"400","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization.","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization.","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing","paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types"},{"label":"List all request types","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/listallrequesttypes","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/listallrequesttypes","metadata":{"seo":{"title":"List all request types","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.read"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAllRequestTypes","name":"List all request types","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all request types","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.read"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all or a subset of request types in your organization."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?filter="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to narrow results with the following request type properties: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters are accepted, and standard link headers are in the response."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"filter","in":"query","schemaId":"schema_1417","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apply various filters by using supported request types filtering properties."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Percent-encoding"},"children":[]}]}]}]}],"examples":{"FilterByStatus":{"summary":"Filter by status","value":"status eq \"ACTIVE\""},"FilterByLastUpdated":{"summary":"Filter by lastUpdated","value":"lastUpdated gt \"2022-05-24T14:15:22Z\""},"FilterByStatusAndLastUpdated":{"summary":"Filter by status and lastUpdated","value":"status eq \"ACTIVE\" AND lastUpdated gt \"2022-05-24T14:15:22Z\""}}},{"name":"after","in":"query","schemaId":"schema_1418","description":"The after cursor provided by a prior request."},{"name":"limit","in":"query","schemaId":"schema_1419","description":"The maximum number of records returned in a response"},{"name":"orderBy","in":"query","schemaId":"schema_1420","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apply an ordering of request types by specifying a supported request type property name with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20asc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20desc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" suffix."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Percent-encoding"},"children":[]}]}]}]}],"examples":{"OrderByCreated":{"summary":"Order by created","value":"created desc"},"OrderByLastUpdated":{"summary":"Order by lastUpdated","value":"lastUpdated desc"}}}],"pointer":"/paths/~1governance~1api~1v1~1request-types/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/governance/api/v1/request-types","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"filter","in":"query","required":false,"example":"status eq \"ACTIVE\"","schemaId":"components/schemas/scim-filter"},{"name":"after","in":"query","required":false,"schemaId":"components/schemas/request-type-id"},{"name":"limit","in":"query","required":false,"schemaId":"schema_1419"},{"name":"orderBy","in":"query","required":false,"example":"created desc","schemaId":"components/schemas/order-by"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","400","401","403","404","429","500"],"pointer":"/governance/api/v1/request-types","href":"request-types/listallrequesttypes","openApiOperationId":"listAllRequestTypes","summary":"List all request types"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful request type list response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-types-list","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter"]}},"schemaId":"components/schemas/request-types-list","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter"],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"400","description":"An invalid request to list request types","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-types-list","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-types-list","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter"]}}},{"code":"400","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types"},{"label":"Retrieve a request type","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/getrequesttype","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/getrequesttype","metadata":{"seo":{"title":"Retrieve a request type","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.readAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRequestType","name":"Retrieve a request type","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a request type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves the full representation of a specific request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"More information is returned than the abbreviated representation in a List request types operation."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestTypeId","in":"path","schemaId":"schema_1418","description":"Unique identifier for the request type","required":true}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/governance/api/v1/request-types/{requestTypeId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestTypeId","in":"path","required":true,"schemaId":"components/schemas/request-type-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","401","403","404","429","500"],"pointer":"/governance/api/v1/request-types/{requestTypeId}","href":"request-types/getrequesttype","openApiOperationId":"getRequestType","summary":"Retrieve a request type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful request type get response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."]}},"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types/{requestTypeId}"},{"label":"Delete a request type","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/deleterequesttype","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/deleterequesttype","metadata":{"seo":{"title":"Delete a request type","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteRequestType","name":"Delete a request type","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a request type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a request type from your organization."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A deleted request type:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can no longer be used to add requests"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can no longer be unpublished or published"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Is no longer available for Get or List operations"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" In-flight requests using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DELETED"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request type continue in their lifecycle operations using the state of the request type at the time the request was made."},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestTypeId","in":"path","schemaId":"schema_1418","description":"Unique identifier for the request type","required":true}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/governance/api/v1/request-types/{requestTypeId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestTypeId","in":"path","required":true,"schemaId":"components/schemas/request-type-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["204","401","403","404","429","500"],"pointer":"/governance/api/v1/request-types/{requestTypeId}","href":"request-types/deleterequesttype","openApiOperationId":"deleteRequestType","summary":"Delete a request type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"A successful request type delete response","headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types/{requestTypeId}"},{"label":"Publish a request type","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/publishrequesttype","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/publishrequesttype","metadata":{"seo":{"title":"Publish a request type","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"publishRequestType","name":"Publish a request type","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Publish a request type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Publishes a request type to your organziation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A published request type:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can be used to create requests"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can be viewed by non-administrative users"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sets the request type's status to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request type with a status of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ACTIVE"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be unpublished or deleted at any time."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestTypeId","in":"path","schemaId":"schema_1418","description":"Unique identifier for the request type","required":true}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/governance/api/v1/request-types/{requestTypeId}/publish","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestTypeId","in":"path","required":true,"schemaId":"components/schemas/request-type-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","401","403","404","409","429","500"],"pointer":"/governance/api/v1/request-types/{requestTypeId}/publish","href":"request-types/publishrequesttype","openApiOperationId":"publishRequestType","summary":"Publish a request type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful request type publish response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"]}},"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example"]},{"code":"409","description":"An invalid request to publish a request type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types/{requestTypeId}/publish"},{"label":"Unpublish a request type","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/unpublishrequesttype","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/unpublishrequesttype","metadata":{"seo":{"title":"Unpublish a request type","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"unpublishRequestType","name":"Unpublish a request type","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Unpublish a request type","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unpublishes a request type, which returns the status of the request type to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DRAFT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An unpublished Request Type:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can't be used to add new requests"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Is not visible to non-administrative users"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" In-flight requests continue in their lifecycle using the request type definition from the point in time the request was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request type with a status of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DRAFT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" can be published or deleted at any time."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestTypeId","in":"path","schemaId":"schema_1418","description":"Unique identifier for the request type","required":true}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/governance/api/v1/request-types/{requestTypeId}/un-publish","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestTypeId","in":"path","required":true,"schemaId":"components/schemas/request-type-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","401","403","404","409","429","500"],"pointer":"/governance/api/v1/request-types/{requestTypeId}/un-publish","href":"request-types/unpublishrequesttype","openApiOperationId":"unpublishRequestType","summary":"Unpublish a request type"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful request type unpublish response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"]}},"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example"]},{"code":"409","description":"An invalid request due to status conflict when unpublishing a request type","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-type-full","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example"]}}},{"code":"409","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/request-types/{requestTypeId}/un-publish"},{"label":"List all teams","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/listallrequestteams","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/request-types/listallrequestteams","metadata":{"seo":{"title":"List all teams","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.readAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAllRequestTeams","name":"List all teams","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1teams/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all teams","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all or a subset of teams in your org."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?filter="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to narrow results with the request type property "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". This query is useful for specifying the team "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Team ID) of a request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters are accepted, and standard link headers are in the response."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"filter","in":"query","schemaId":"schema_1417","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apply various filters by using supported team filtering properties."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Percent-encoding"},"children":[]}]}]}]}],"examples":{"FilterByName":{"summary":"Filter by name","value":"name eq \"Salesforce admins\""}}},{"name":"after","in":"query","schemaId":"schema_1422","description":"The after cursor provided by a prior request."},{"name":"limit","in":"query","schemaId":"schema_1419","description":"The maximum number of records returned in a response"}],"pointer":"/paths/~1governance~1api~1v1~1teams/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/governance/api/v1/teams","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"filter","in":"query","required":false,"example":"name eq \"Salesforce admins\"","schemaId":"components/schemas/scim-filter"},{"name":"after","in":"query","required":false,"schemaId":"components/schemas/team-id"},{"name":"limit","in":"query","required":false,"schemaId":"schema_1419"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","400","401","403","500"],"pointer":"/governance/api/v1/teams","href":"request-types/listallrequestteams","openApiOperationId":"listAllRequestTeams","summary":"List all teams"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful teams list response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/teams-list","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams"]}},"schemaId":"components/schemas/teams-list","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams"],"headers":{"Link":{"$ref":"#/components/headers/link"}},"headerSchemaId":"schema_1423"},{"code":"400","description":"An invalid request to list teams","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1teams/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/teams-list","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/teams-list","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams"]}}},{"code":"400","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/teams"}],"content":{"contentType":"group","meta":{"name":"Request Types"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Request Types","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Request Types API allows you to manage request types, similar to the operations performed in the Okta Access Requests app. Use this API to define request types that include:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fields to complete"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Approvals and tasks required"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Actions performed in Okta"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://help.okta.com/okta_help.htm?type=oie&id=ext-ar-reqtype"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access Request Types"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the product documentation."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each org has a limit of 500 active request types."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Operations to create or delete apps or groups in Okta could take up to 24 hours before they can be referenced by the Access Requests - V1 APIs. To trigger these changes immediately, open Okta Access Requests as an administrator, go to "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Settings"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" > "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configuration"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and click "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sync Now"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on the relevant Okta resource list."},"children":[]}]}]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/governance/api/v1/request-types","summary":"Create a request type","prefix":{"name":"post","color":"post"},"badges":[],"link":"/request-types/createrequesttype","deprecated":false},{"title":"/governance/api/v1/request-types","summary":"List all request types","prefix":{"name":"get","color":"get"},"badges":[],"link":"/request-types/listallrequesttypes","deprecated":false},{"title":"/governance/api/v1/request-types/{requestTypeId}","summary":"Retrieve a request type","prefix":{"name":"get","color":"get"},"badges":[],"link":"/request-types/getrequesttype","deprecated":false},{"title":"/governance/api/v1/request-types/{requestTypeId}","summary":"Delete a request type","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/request-types/deleterequesttype","deprecated":false},{"title":"/governance/api/v1/request-types/{requestTypeId}/publish","summary":"Publish a request type","prefix":{"name":"post","color":"post"},"badges":[],"link":"/request-types/publishrequesttype","deprecated":false},{"title":"/governance/api/v1/request-types/{requestTypeId}/un-publish","summary":"Unpublish a request type","prefix":{"name":"post","color":"post"},"badges":[],"link":"/request-types/unpublishrequesttype","deprecated":false},{"title":"/governance/api/v1/teams","summary":"List all teams","prefix":{"name":"get","color":"get"},"badges":[],"link":"/request-types/listallrequestteams","deprecated":false}]}]}]}]}},{"type":"group","label":"Requests","link":"/iga/openapi/governance-production-requests-admin-v1-reference/requests","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/requests","items":[{"label":"List all requests","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/listallrequests","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/listallrequests","metadata":{"seo":{"title":"List all requests","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.readAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listAllRequests","name":"List all requests","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1requests/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List all requests","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lists all or a subset of requests made by users in your organization."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?filter="},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to narrow results with the following request properties: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestStatus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lastUpdated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameters are accepted, and standard link headers are in the response."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"filter","in":"query","schemaId":"schema_1417","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apply various filters by using supported request filtering properties."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Percent-encoding"},"children":[]}]}]}]}],"examples":{"FilterByRequestStatus":{"summary":"Filter by requestStatus","value":"requestStatus eq \"RESOLVED\""},"FilterByLastUpdated":{"summary":"Filter by lastUpdated","value":"lastUpdated gt \"2022-05-24T14:15:22Z\""},"FilterByRequestStatusAndLastUpdated":{"summary":"Filter by requestStatus and lastUpdated","value":"requestStatus eq \"RESOLVED\" AND lastUpdated gt \"2022-05-24T14:15:22Z\""}}},{"name":"after","in":"query","schemaId":"schema_1424","description":"The after cursor provided by a prior request."},{"name":"limit","in":"query","schemaId":"schema_1419","description":"The maximum number of records returned in a response"},{"name":"orderBy","in":"query","schemaId":"schema_1420","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Apply an ordering of requests by specifying a supported request property name with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20asc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20desc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" suffix."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Query parameter percent encoding is required. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Percent-encoding"},"children":[]}]}]}]}],"examples":{"OrderByCreated":{"summary":"Order by created","value":"created desc"},"OrderByLastUpdated":{"summary":"Order by lastUpdated","value":"lastUpdated desc"}}}],"pointer":"/paths/~1governance~1api~1v1~1requests/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/governance/api/v1/requests","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[{"name":"filter","in":"query","required":false,"example":"requestStatus eq \"RESOLVED\"","schemaId":"components/schemas/scim-filter"},{"name":"after","in":"query","required":false,"schemaId":"components/schemas/request-id"},{"name":"limit","in":"query","required":false,"schemaId":"schema_1419"},{"name":"orderBy","in":"query","required":false,"example":"created desc","schemaId":"components/schemas/order-by"}],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","400","401","403","429","500"],"pointer":"/governance/api/v1/requests","href":"requests/listallrequests","openApiOperationId":"listAllRequests","summary":"List all requests"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful request list response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-list","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter"]}},"schemaId":"components/schemas/request-list","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter"],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"400","description":"An invalid request to list requests","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1requests/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-list","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-list","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter"]}}},{"code":"400","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/requests"},{"label":"Create a request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/createrequest","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/createrequest","metadata":{"seo":{"title":"Create a request","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createRequest","name":"Create a request","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1requests/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a request to access a resource in your organization."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When creating a request, you specify:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request type ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestTypeId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") to use for the request"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and the subject line ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"subject"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") of the request"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optionally, you can specify:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The requester user IDs for the request. If not provided, user IDs are obtained from the user identity of the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"API Token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Access Token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"]}},"schemaId":"components/schemas/request-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"],"pointer":"/paths/~1governance~1api~1v1~1requests/post/requestBody","description":"The writable attributes of a request"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/governance/api/v1/requests","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/request-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"]}},"responseCodes":["201","400","401","403","409","500"],"pointer":"/governance/api/v1/requests","href":"requests/createrequest","openApiOperationId":"createRequest","summary":"Create a request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/request-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"A successful create request response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required"]}},"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required"],"headers":{"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1416"},{"code":"400","description":"An invalid request to create a request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid"]},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"When authorization fails","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user."]},{"code":"409","description":"A conflict with the request type prevents the create request operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1requests/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required"]}}},{"code":"400","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid"]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user."]}}},{"code":"409","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/requests"},{"label":"Retrieve a request","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/getrequest","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/getrequest","metadata":{"seo":{"title":"Retrieve a request","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.readAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRequest","name":"Retrieve a request","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Retrieve a request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.read"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves the full representation of a specific request"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"More information is returned than the abbreviated representation in a "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/listallrequests"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all requests"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestId","in":"path","schemaId":"schema_1424","description":"Unique identifier for the request","required":true}],"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/governance/api/v1/requests/{requestId}","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestId","in":"path","required":true,"schemaId":"components/schemas/request-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200","401","403","404","429","500"],"pointer":"/governance/api/v1/requests/{requestId}","href":"requests/getrequest","openApiOperationId":"getRequest","summary":"Retrieve a request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A successful get request response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future."]}},"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future."],"headers":{"Link":{"$ref":"#/components/headers/link"},"X-Rate-Limit-Limit":{"$ref":"#/components/headers/rate-limit-limit"},"X-Rate-Limit-Remaining":{"$ref":"#/components/headers/rate-limit-remaining"},"X-Rate-Limit-Reset":{"$ref":"#/components/headers/rate-limit-reset"}},"headerSchemaId":"schema_1421"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"403","description":"Authorization fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example"]},{"code":"404","description":"The requested resource wasn't found error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example"]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/request-full","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future."]}}},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"403","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example"]}}},{"code":"404","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example"]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/requests/{requestId}"},{"label":"Create a Message for a Request","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/createrequestmessage","routeSlug":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/createrequestmessage","metadata":{"seo":{"title":"Create a Message for a Request","description":"BetaOAuth 2.0 scope:okta.governance.accessRequests.manageAdmin roles:ACCESS_REQUESTS_ADMIN"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createRequestMessage","name":"Create a Message for a Request","isWebhook":false,"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a Message for a Request","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"marginTop":"16px","marginBottom":"24px","fontFamily":"sans-serif","display":"block","clear":"both"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"span","attrs":{"className":"lifecycle-badge beta","style":{"cursor":"pointer","background":"rgb(255, 198, 28)","borderRadius":"6px","marginRight":"8px","padding":"3px","fontSize":"16px","verticalAlign":"super","color":"white","fontWeight":"bold","display":"inline-block"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Beta"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/oauth2/","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"OAuth 2.0 scope:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"okta.governance.accessRequests.manage"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"div","attrs":{"style":{"display":"flex","alignItems":"flex-start","gap":"8px","marginTop":"12px"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"a","attrs":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/guides/roles/#iam-access-to-api-resources","style":{"padding":"4px 0px","flex":"0 0 135px","fontSize":"16px","fontWeight":"600","color":"#1d1d21","textDecoration":"none","marginBottom":"8px"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"Admin roles:"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"ul","attrs":{"style":{"padding":"0","margin":"0","listStyle":"none","display":"flex","flexWrap":"wrap","flex":"1"}}},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{"style":{"display":"inline-flex","alignItems":"center","backgroundColor":"#ededed","color":"#4b4b4b","padding":"4px 12px","borderRadius":"16px","fontSize":"14px","marginRight":"8px","marginBottom":"8px","lineHeight":"20px","border":"1px solid transparent"}}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"ACCESS_REQUESTS_ADMIN"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a message to add context to the request. Message will be authored by the authenticated user and display as \"Sent via API\"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"requestId","in":"path","schemaId":"schema_1424","description":"Unique identifier for the request","required":true}],"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-message-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."]}},"schemaId":"components/schemas/request-message-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."],"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody","description":"The writable attributes of a request message"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/governance/api/v1/requests/{requestId}/messages","servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"parameters":{"path":[{"name":"requestId","in":"path","required":true,"schemaId":"components/schemas/request-id"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"components/schemas/request-message-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."]}},"responseCodes":["201","401","429","500"],"pointer":"/governance/api/v1/requests/{requestId}/messages","href":"requests/createrequestmessage","openApiOperationId":"createRequestMessage","summary":"Create a Message for a Request"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com"}}}],"schemaId":"components/schemas/request-message-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/request-message-creatable","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.","paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"A successful create request message response"},{"code":"401","description":"Authentication fails error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]},{"code":"429","description":"The rate limit has been exceeded error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example"]},{"code":"500","description":"Error response when a server fault occurs due to an unexpected error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"401","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."]}}},{"code":"429","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/error","exampleIds":["paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]}]},"httpPath":"/governance/api/v1/requests/{requestId}/messages"}],"content":{"contentType":"group","meta":{"name":"Requests"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Requests","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta Access Requests automate the process of requesting access to resources like apps, groups, and entitlement bundles."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each request is associated with a request approval process that determines the actions taken by Okta Access Requests."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Manage this process directly with the following request APIs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://help.okta.com/okta_help.htm?type=oie&id=ext-ar"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access Requests"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more information on Access Requests"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and Identity Governance."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/governance/api/v1/requests","summary":"List all requests","prefix":{"name":"get","color":"get"},"badges":[],"link":"/requests/listallrequests","deprecated":false},{"title":"/governance/api/v1/requests","summary":"Create a request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/requests/createrequest","deprecated":false},{"title":"/governance/api/v1/requests/{requestId}","summary":"Retrieve a request","prefix":{"name":"get","color":"get"},"badges":[],"link":"/requests/getrequest","deprecated":false},{"title":"/governance/api/v1/requests/{requestId}/messages","summary":"Create a Message for a Request","prefix":{"name":"post","color":"post"},"badges":[],"link":"/requests/createrequestmessage","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/scim-filter":{"id":"components/schemas/scim-filter","kind":"json-schema","title":"scim-filter","data":{"type":"string","format":"scim-filter"}},"components/schemas/request-type-id":{"id":"components/schemas/request-type-id","kind":"json-schema","title":"request-type-id","data":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"request-type-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request type "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"components/schemas/order-by":{"id":"components/schemas/order-by","kind":"json-schema","title":"order-by","data":{"type":"string","format":"order-by","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A property of items within the collection, optionally followed by a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20asc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"%20desc"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" suffix."},"children":[]}]}]}]}},"components/schemas/writable-standard-properties":{"id":"components/schemas/writable-standard-properties","kind":"json-schema","title":"writable-standard-properties","data":{"type":"object","properties":{"name":{"type":"string","nullable":false,"description":"A user-defined unique key that's set during the create operation and can't be updated afterwards","maxLength":50,"minLength":1},"description":{"type":"string","nullable":false,"description":"Human readable description","maxLength":2000,"minLength":1}},"example":{"name":"my-object-1","description":"The unique instance of my-object-1"}}},"components/schemas/created-by":{"id":"components/schemas/created-by","kind":"json-schema","title":"created-by","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the Okta user who created the resource"},"children":[]}]}]}],"type":"string","x-okta-ignore-redocly-rules-for-sdk":true,"readOnly":true,"minLength":1,"maxLength":20,"format":"okta-user-id"}},"components/schemas/created":{"id":"components/schemas/created","kind":"json-schema","title":"created","data":{"description":"The ISO 8601 formatted date and time when the resource was created","type":"string","x-okta-ignore-redocly-rules-for-sdk":true,"format":"date-time","readOnly":true}},"components/schemas/last-updated":{"id":"components/schemas/last-updated","kind":"json-schema","title":"last-updated","data":{"description":"The ISO 8601 formatted date and time when the object was last updated","type":"string","format":"date-time","readOnly":true}},"components/schemas/last-updated-by":{"id":"components/schemas/last-updated-by","kind":"json-schema","title":"last-updated-by","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the Okta user who last updated the object"},"children":[]}]}]}],"type":"string","x-okta-ignore-redocly-rules-for-sdk":true,"readOnly":true,"minLength":1,"maxLength":20,"format":"okta-user-id"}},"components/schemas/link":{"id":"components/schemas/link","kind":"json-schema","title":"link","data":{"type":"object","x-okta-ignore-redocly-rules-for-sdk":true,"description":"A link to a related RESTful resource","required":["href"],"properties":{"name":{"type":"string","description":"Link name"},"rel":{"type":"string","description":"Link relation"},"href":{"type":"string","minLength":1,"description":"Link URI"},"type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The media type of the link. If omitted, it's implicitly "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"application/json"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"method":{"type":"string","deprecated":true},"templated":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the link object's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"href"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" property is a URI template"},"children":[]}]}]}]},"hints":{"type":"object","description":"Link hints","additionalProperties":{"type":"array","items":{"type":"string"}}},"title":{"type":"string","description":"Link title or label"}}}},"components/schemas/read-only-standard-properties":{"id":"components/schemas/read-only-standard-properties","kind":"json-schema","title":"read-only-standard-properties","data":{"type":"object","x-okta-ignore-redocly-rules-for-sdk":true,"required":["id","createdBy","created","lastUpdated","lastUpdatedBy"],"properties":{"id":{"description":"Unique identifier for the object","type":"string","minLength":1},"createdBy":{"$ref":"#/components/schemas/created-by"},"created":{"$ref":"#/components/schemas/created"},"lastUpdated":{"$ref":"#/components/schemas/last-updated"},"lastUpdatedBy":{"$ref":"#/components/schemas/last-updated-by"},"_links":{"type":"object","description":"Links to related resources","additionalProperties":{"$ref":"#/components/schemas/link"}}}}},"components/schemas/request-type-status":{"id":"components/schemas/request-type-status","kind":"json-schema","title":"request-type-status","data":{"type":"string","enum":["DRAFT","ACTIVE","DISABLED"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request type has a status lifecycle described in our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#request-type-status-lifecycle"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request type lifecycle documentation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request type may start with a status of DRAFT or ACTIVE, based on the status property in the Add request body."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The publish, unpublish, and delete operations all affect a request type's status."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additionally, if any operation detects invalid settings, such as an approver who is no longer in the organization, the request type automatically transitions to disabled."},"children":[]}]}]}]}},"components/schemas/request-type-links":{"id":"components/schemas/request-type-links","kind":"json-schema","title":"request-type-links","data":{"type":"object","description":"Links available on a single request type representation","required":["requests","self"],"properties":{"createRequest":{"description":"Only available for request type with status of ACTIVE","allOf":[{"$ref":"#/components/schemas/link"}]},"requests":{"$ref":"#/components/schemas/link"},"self":{"$ref":"#/components/schemas/link"}},"additionalProperties":{"$ref":"#/components/schemas/link"}}},"components/schemas/request-type-sparse":{"id":"components/schemas/request-type-sparse","kind":"json-schema","title":"request-type-sparse","data":{"type":"object","description":"Sparse representation of a Request Type resource","allOf":[{"$ref":"#/components/schemas/writable-standard-properties"},{"$ref":"#/components/schemas/read-only-standard-properties"}],"required":["id","name","description","lastUpdated","lastUpdatedBy","status","lastUpdateSource","_links"],"properties":{"status":{"$ref":"#/components/schemas/request-type-status"},"lastUpdateSource":{"type":"string","enum":["API"]},"_links":{"$ref":"#/components/schemas/request-type-links"}},"example":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=0oa1gjh63g214q0Hq0g4","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb2db568c7c300079fefd0","type":"application/json"}}}}},"components/schemas/request-types-list-links":{"id":"components/schemas/request-types-list-links","kind":"json-schema","title":"request-types-list-links","data":{"type":"object","description":"Links available in request type list response","required":["self"],"properties":{"self":{"$ref":"#/components/schemas/link"},"next":{"$ref":"#/components/schemas/link"}},"additionalProperties":{"$ref":"#/components/schemas/link"}}},"components/schemas/request-types-list":{"id":"components/schemas/request-types-list","kind":"json-schema","title":"request-types-list","data":{"type":"object","properties":{"data":{"description":"All Request Types on the current page","type":"array","items":{"$ref":"#/components/schemas/request-type-sparse"}},"_links":{"$ref":"#/components/schemas/request-types-list-links"}}}},"components/schemas/error-cause":{"id":"components/schemas/error-cause","kind":"json-schema","title":"error-cause","data":{"type":"object","x-okta-ignore-redocly-rules-for-sdk":true,"description":"A specific cause of an error","required":["errorSummary"],"properties":{"errorSummary":{"type":"string","description":"A more specific summary for the error that contains the error cause"},"reason":{"type":"string","description":"An enumerated value to represent the reason why the error occurred. This enumeration allows codes to adapt to different conditions in which an error code can occur."},"location":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A value that represents the key where the error cause occurred. This is used with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"locationType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to give a holistic view of where the error cause occurred. For example, if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"locationType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"body"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"username"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reason"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"UNIQUE_CONSTRAINT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", you can derive that the username was already taken."},"children":[]}]}]}]},"locationType":{"type":"string","description":"A value that represents where the error cause occurred. For example, in the body or header of the request. This value isn't required for cases where the request is correct, but there was another reason why the error occurred (server-side state conflict, rate limit violation, and so on)."},"domain":{"type":"string","description":"A value that represents the domain of the service in which the error occurs. This value is used to isolate the error cause reason."}}}},"components/schemas/error":{"id":"components/schemas/error","kind":"json-schema","title":"error","data":{"type":"object","description":"An Error object","required":["errorCode","errorId","errorSummary"],"properties":{"errorCode":{"type":"string","description":"An error code unique to the error"},"errorId":{"type":"string","description":"An error identifier useful for troubleshooting an error with support"},"errorSummary":{"type":"string","description":"An error code description detailing the error"},"errorLink":{"type":"string","description":"An indicator of where to look to troubleshoot the error"},"errorCauses":{"type":"array","description":"An optional array of string values that explain possible reasons for the error","items":{"$ref":"#/components/schemas/error-cause"}}}}},"components/schemas/request-type-creatable-status":{"id":"components/schemas/request-type-creatable-status","kind":"json-schema","title":"request-type-creatable-status","data":{"type":"string","enum":["DRAFT","ACTIVE"],"default":"DRAFT","description":"Whether the request type starts with a status of DRAFT or ACTIVE. Starting as ACTIVE is preferable to avoid a publish operation when no manual inspection of the request type is necessary before publication."}},"components/schemas/request-type-owner-id":{"id":"components/schemas/request-type-owner-id","kind":"json-schema","title":"request-type-owner-id","data":{"type":"string","description":"The ID of the team that administers this request type.","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"owner-id"}},"components/schemas/application-id":{"id":"components/schemas/application-id","kind":"json-schema","title":"application-id","data":{"type":"string","format":"okta-application-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Okta app ID"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/management/tags/application/other/listapplications"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all apps"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" endpoint for more information on how to retrieve app IDs."},"children":[]}]}]}],"pattern":"0oa[0-9a-zA-Z]+","maxLength":20,"minLength":20}},"components/schemas/okta-application-resource":{"id":"components/schemas/okta-application-resource","kind":"json-schema","title":"okta-application-resource","data":{"type":"object","description":"Identifies a unique Okta resource","required":["resourceId"],"properties":{"resourceId":{"$ref":"#/components/schemas/application-id"}}}},"components/schemas/request-type-resource-settings-apps":{"id":"components/schemas/request-type-resource-settings-apps","kind":"json-schema","title":"request-type-resource-settings-apps","data":{"type":"object","description":"Specifies that all resources must be Okta apps","required":["type","targetResources"],"properties":{"type":{"type":"string","enum":["APPS"]},"targetResources":{"type":"array","description":"List of Okta applications","minItems":1,"maxItems":1,"items":{"$ref":"#/components/schemas/okta-application-resource"}}}}},"components/schemas/group-id":{"id":"components/schemas/group-id","kind":"json-schema","title":"group-id","data":{"type":"string","format":"okta-group-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Okta group ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/management/group/listgroups"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all groups"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for more information on how to retrieve group IDs."},"children":[]}]}]}]}],"pattern":"00g[0-9a-zA-Z]+","maxLength":20,"minLength":20}},"components/schemas/okta-group-resource":{"id":"components/schemas/okta-group-resource","kind":"json-schema","title":"okta-group-resource","data":{"type":"object","description":"Identifies a unique Okta group resource","required":["resourceId"],"properties":{"resourceId":{"$ref":"#/components/schemas/group-id"}}}},"components/schemas/request-type-resource-settings-groups":{"id":"components/schemas/request-type-resource-settings-groups","kind":"json-schema","title":"request-type-resource-settings-groups","data":{"type":"object","description":"Specifies that all resources must be Okta groups","required":["type","targetResources"],"properties":{"type":{"type":"string","enum":["GROUPS"]},"targetResources":{"type":"array","description":"List of Okta groups","minItems":1,"maxItems":1,"items":{"$ref":"#/components/schemas/okta-group-resource"}}}}},"components/schemas/entitlement-bundle-id":{"id":"components/schemas/entitlement-bundle-id","kind":"json-schema","title":"entitlement-bundle-id","data":{"type":"string","maxLength":20,"minLength":20,"format":"entitlement-bundle-id","pattern":"enb[0-9a-zA-Z]+","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The entitlement bundle "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]}]}]}]}},"components/schemas/okta-entitlement-bundle-resource":{"id":"components/schemas/okta-entitlement-bundle-resource","kind":"json-schema","title":"okta-entitlement-bundle-resource","data":{"type":"object","description":"Identifies a unique Okta entitlement bundle resource","required":["resourceId"],"properties":{"resourceId":{"$ref":"#/components/schemas/entitlement-bundle-id"}}}},"components/schemas/request-type-resource-settings-entitlement-bundles":{"id":"components/schemas/request-type-resource-settings-entitlement-bundles","kind":"json-schema","title":"request-type-resource-settings-entitlement-bundles","data":{"type":"object","description":"Specifies that all resources must be Okta entitlement bundles","required":["type","targetResources"],"properties":{"type":{"type":"string","enum":["ENTITLEMENT_BUNDLES"]},"targetResources":{"type":"array","description":"List of Okta entitlement bundles","minItems":1,"maxItems":1,"items":{"$ref":"#/components/schemas/okta-entitlement-bundle-resource"}}}}},"components/schemas/request-type-resource-settings-mutable":{"id":"components/schemas/request-type-resource-settings-mutable","kind":"json-schema","title":"request-type-resource-settings-mutable","data":{"type":"object","description":"Which resource(s) are requestable","oneOf":[{"$ref":"#/components/schemas/request-type-resource-settings-apps"},{"$ref":"#/components/schemas/request-type-resource-settings-groups"},{"$ref":"#/components/schemas/request-type-resource-settings-entitlement-bundles"}],"discriminator":{"propertyName":"type","mapping":{"APPS":"#/components/schemas/request-type-resource-settings-apps","GROUPS":"#/components/schemas/request-type-resource-settings-groups","ENTITLEMENT_BUNDLES":"#/components/schemas/request-type-resource-settings-entitlement-bundles"}}}},"components/schemas/okta-push-group-id":{"id":"components/schemas/okta-push-group-id","kind":"json-schema","title":"okta-push-group-id","data":{"type":"string","format":"okta-push-group-id","description":"An Okta Group ID that's used for push groups in Okta.","example":"00g1emaKYZTWRYYRRTSK","pattern":"00g[0-9a-zA-Z]+","maxLength":20,"minLength":20}},"components/schemas/member-of":{"id":"components/schemas/member-of","kind":"json-schema","title":"member-of","data":{"type":"array","description":"Okta groups that the user persona must be a member of","minItems":1,"maxItems":1,"items":{"$ref":"#/components/schemas/okta-push-group-id"}}},"components/schemas/field-prompt":{"id":"components/schemas/field-prompt","kind":"json-schema","title":"field-prompt","data":{"type":"string","description":"Text to prompt the user with","minLength":1,"maxLength":100,"example":"What is the business justification?"}},"components/schemas/field-required":{"id":"components/schemas/field-required","kind":"json-schema","title":"field-required","data":{"type":"boolean","description":"Whether a value to this field is required to advance the request","example":true,"default":true}},"components/schemas/base-field-writable":{"id":"components/schemas/base-field-writable","kind":"json-schema","title":"base-field-writable","data":{"type":"object","description":"The field to use when prompting the user","required":["prompt"],"properties":{"prompt":{"$ref":"#/components/schemas/field-prompt"},"required":{"$ref":"#/components/schemas/field-required"}}}},"components/schemas/field-select-type":{"id":"components/schemas/field-select-type","kind":"json-schema","title":"field-select-type","data":{"type":"string","enum":["SELECT"]}},"components/schemas/field-option-value":{"id":"components/schemas/field-option-value","kind":"json-schema","title":"field-option-value","data":{"type":"string","description":"The value of a select option","maxLength":280,"minLength":1}},"components/schemas/field-option":{"id":"components/schemas/field-option","kind":"json-schema","title":"field-option","data":{"type":"object","description":"An option for the user to select for a field prompt","required":["value"],"properties":{"value":{"$ref":"#/components/schemas/field-option-value"}}}},"components/schemas/field-select-options":{"id":"components/schemas/field-select-options","kind":"json-schema","title":"field-select-options","data":{"type":"array","description":"The options available for the select input","maxItems":25,"minItems":1,"items":{"$ref":"#/components/schemas/field-option"}}},"components/schemas/field-select-writable":{"id":"components/schemas/field-select-writable","kind":"json-schema","title":"field-select-writable","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-writable"}],"description":"A select field","required":["type","options"],"properties":{"type":{"$ref":"#/components/schemas/field-select-type"},"options":{"$ref":"#/components/schemas/field-select-options"}}}},"components/schemas/field-text-type":{"id":"components/schemas/field-text-type","kind":"json-schema","title":"field-text-type","data":{"type":"string","enum":["TEXT"]}},"components/schemas/field-text-writable":{"id":"components/schemas/field-text-writable","kind":"json-schema","title":"field-text-writable","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-writable"}],"description":"A text field","required":["type"],"properties":{"type":{"$ref":"#/components/schemas/field-text-type"}}}},"components/schemas/field-date-time-type":{"id":"components/schemas/field-date-time-type","kind":"json-schema","title":"field-date-time-type","data":{"type":"string","enum":["DATE-TIME"]}},"components/schemas/field-date-writable":{"id":"components/schemas/field-date-writable","kind":"json-schema","title":"field-date-writable","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-writable"}],"description":"A date field","required":["type"],"properties":{"type":{"$ref":"#/components/schemas/field-date-time-type"}}}},"components/schemas/field-writable":{"id":"components/schemas/field-writable","kind":"json-schema","title":"field-writable","data":{"description":"The field to use when prompting the user","oneOf":[{"$ref":"#/components/schemas/field-select-writable"},{"$ref":"#/components/schemas/field-text-writable"},{"$ref":"#/components/schemas/field-date-writable"}],"discriminator":{"propertyName":"type","mapping":{"SELECT":"#/components/schemas/field-select-writable","TEXT":"#/components/schemas/field-text-writable","DATE-TIME":"#/components/schemas/field-date-writable"}},"default":{"type":"TEXT","required":true}}},"components/schemas/fields-writable":{"id":"components/schemas/fields-writable","kind":"json-schema","title":"fields-writable","data":{"type":"array","description":"A list of fields with which to gather input. The order of the fields in the array controls the order that the fields are presented to users.","default":[],"maxItems":5,"items":{"$ref":"#/components/schemas/field-writable"}}},"components/schemas/request-type-requester-member-of-writable":{"id":"components/schemas/request-type-requester-member-of-writable","kind":"json-schema","title":"request-type-requester-member-of-writable","data":{"type":"object","description":"A request where the requester that must be a member of a particular Okta Group.","required":["type","requesterMemberOf"],"properties":{"type":{"type":"string","enum":["MEMBER_OF"]},"requesterMemberOf":{"$ref":"#/components/schemas/member-of"},"requesterFields":{"$ref":"#/components/schemas/fields-writable"}}}},"components/schemas/request-type-requester-everyone-writable":{"id":"components/schemas/request-type-requester-everyone-writable","kind":"json-schema","title":"request-type-requester-everyone-writable","data":{"type":"object","description":"A request where the requester may be any Okta user in the Okta organization.","required":["type"],"properties":{"type":{"type":"string","enum":["EVERYONE"]},"requesterFields":{"$ref":"#/components/schemas/fields-writable"}}}},"components/schemas/request-type-request-settings-mutable":{"id":"components/schemas/request-type-request-settings-mutable","kind":"json-schema","title":"request-type-request-settings-mutable","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestSettings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" control:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which users can request access using this request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What fields the user may or must fill out in order to request access."},"children":[]}]}]}]}],"default":{"type":"EVERYONE","requesterFields":[]},"oneOf":[{"$ref":"#/components/schemas/request-type-requester-member-of-writable"},{"$ref":"#/components/schemas/request-type-requester-everyone-writable"}],"discriminator":{"propertyName":"type","mapping":{"MEMBER_OF":"#/components/schemas/request-type-requester-member-of-writable","EVERYONE":"#/components/schemas/request-type-requester-everyone-writable"}}}},"components/schemas/request-type-approver-fields-writable":{"id":"components/schemas/request-type-approver-fields-writable","kind":"json-schema","title":"request-type-approver-fields-writable","data":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of fields with which to gather input."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The order of field object controls the order with which the fields are presented to users."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Known limitation"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unlike requester fields, all approver fields are "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and may not be set as optional."},"children":[]}]}]}],"default":[],"maxItems":5,"items":{"$ref":"#/components/schemas/field-writable"}}},"components/schemas/request-type-approval-member-of-writable":{"id":"components/schemas/request-type-approval-member-of-writable","kind":"json-schema","title":"request-type-approval-member-of-writable","data":{"type":"object","description":"An approval when the approver must be a member of a particular Okta Group.","required":["approverType","approverMemberOf"],"properties":{"approverType":{"type":"string","enum":["MEMBER_OF"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverMemberOf":{"$ref":"#/components/schemas/member-of"},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields-writable"}}}},"components/schemas/user-id":{"id":"components/schemas/user-id","kind":"json-schema","title":"user-id","data":{"type":"string","x-okta-ignore-redocly-rules-for-sdk":true,"format":"okta-user-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Okta user "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]}]}]}],"maxLength":20,"minLength":20,"pattern":"00u[0-9a-zA-Z]+","example":"00ub0oNGTSWTBKOLGLNR"}},"components/schemas/request-type-approval-user-writable":{"id":"components/schemas/request-type-approval-user-writable","kind":"json-schema","title":"request-type-approval-user-writable","data":{"type":"object","description":"An approval when the approver must be a particular user.","required":["approverType","approverUserId"],"properties":{"approverType":{"type":"string","enum":["USER"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverUserId":{"$ref":"#/components/schemas/user-id"},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields-writable"}}}},"components/schemas/request-type-approval-manager-writable":{"id":"components/schemas/request-type-approval-manager-writable","kind":"json-schema","title":"request-type-approval-manager-writable","data":{"type":"object","description":"Specifying the approver must be the requester's manager","required":["approverType"],"properties":{"approverType":{"type":"string","enum":["MANAGER"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields-writable"}}}},"components/schemas/request-type-approval-resource-owner-writable":{"id":"components/schemas/request-type-approval-resource-owner-writable","kind":"json-schema","title":"request-type-approval-resource-owner-writable","data":{"type":"object","description":"Specifying the approver must be the resource owner","required":["approverType"],"properties":{"approverType":{"type":"string","enum":["RESOURCE_OWNER"]},"description":{"type":"string","minLength":1,"maxLength":250}}}},"components/schemas/request-type-approval-writable":{"id":"components/schemas/request-type-approval-writable","kind":"json-schema","title":"request-type-approval-writable","data":{"type":"object","description":"request-type-approval-description.md","oneOf":[{"$ref":"#/components/schemas/request-type-approval-member-of-writable"},{"$ref":"#/components/schemas/request-type-approval-user-writable"},{"$ref":"#/components/schemas/request-type-approval-manager-writable"},{"$ref":"#/components/schemas/request-type-approval-resource-owner-writable"}],"discriminator":{"propertyName":"approverType","mapping":{"MEMBER_OF":"#/components/schemas/request-type-approval-member-of-writable","USER":"#/components/schemas/request-type-approval-user-writable","MANAGER":"#/components/schemas/request-type-approval-manager-writable","RESOURCE_OWNER":"#/components/schemas/request-type-approval-resource-owner-writable"}}}},"components/schemas/request-type-approvals-writable":{"id":"components/schemas/request-type-approvals-writable","kind":"json-schema","title":"request-type-approvals-writable","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SERIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" approvals required to grant access:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All specified approvals are considered required in order to fulfill an access request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one approval must be specified for a request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a request type has two approvals:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the first approval is immediately actionable by an approver in the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After an approver has made a decision for the first approval, then the second approval is actionable."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approval type of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"RESOURCE_OWNER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported for apps, entitlement bundles, and associated groups from the resource requested."},"children":[]}]}]}]}],"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/request-type-approval-writable"}}},"components/schemas/request-type-approval-settings-serial-writable":{"id":"components/schemas/request-type-approval-settings-serial-writable","kind":"json-schema","title":"request-type-approval-settings-serial-writable","data":{"type":"object","description":"Settings for approval","required":["type","approvals"],"properties":{"type":{"type":"string","enum":["SERIAL"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multiple approvals defined in a serial sequence:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An approval isn't actionable until the previous approval is approved."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An approval denial terminates the request and no subsequent approvals are actionable."},"children":[]}]}]}]}]},"approvals":{"$ref":"#/components/schemas/request-type-approvals-writable"}}}},"components/schemas/request-type-approval-settings-none":{"id":"components/schemas/request-type-approval-settings-none","kind":"json-schema","title":"request-type-approval-settings-none","data":{"type":"object","description":"Settings for no approvals","required":["type"],"properties":{"type":{"type":"string","enum":["NONE"],"description":"No approvals are required for this request type."}}}},"components/schemas/request-type-approval-settings-mutable":{"id":"components/schemas/request-type-approval-settings-mutable","kind":"json-schema","title":"request-type-approval-settings-mutable","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specify one of the following "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of approval settings:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Type"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"NONE"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This request type doesn't need any approval."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SERIAL"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This request type needs at least one approval."},"children":[]}]}]}]}]}]}],"oneOf":[{"$ref":"#/components/schemas/request-type-approval-settings-serial-writable"},{"$ref":"#/components/schemas/request-type-approval-settings-none"}],"discriminator":{"propertyName":"type","mapping":{"SERIAL":"#/components/schemas/request-type-approval-settings-serial-writable","NONE":"#/components/schemas/request-type-approval-settings-none"}}}},"components/schemas/request-duration":{"id":"components/schemas/request-duration","kind":"json-schema","title":"request-duration","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"How long the requester retains access after their request is approved and fulfilled."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specified in "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/ISO_8601#Durations"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 duration format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Known limitation"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only single time unit ISO 8601 duration formats (D, H, M) are supported for units (days, hours, minutes)."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unit"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"D, days"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"P40D"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"H, hours"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PT65H"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"M, minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PT90M"},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Mixes of units, as well as month/year/week designations, aren't supported. For example, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P40DT65H"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P40M"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1W"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"P1Y"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" aren't supported."},"children":[]}]}]}]}],"type":"string","example":"P40D","format":"iso-duration","nullable":true,"default":null}},"components/schemas/request-type-creatable":{"id":"components/schemas/request-type-creatable","kind":"json-schema","title":"request-type-creatable","data":{"type":"object","description":"The properties expected in an initial Add request","required":["name","resourceSettings","approvalSettings","ownerId"],"allOf":[{"$ref":"#/components/schemas/writable-standard-properties"}],"properties":{"status":{"$ref":"#/components/schemas/request-type-creatable-status"},"ownerId":{"$ref":"#/components/schemas/request-type-owner-id"},"resourceSettings":{"$ref":"#/components/schemas/request-type-resource-settings-mutable"},"requestSettings":{"$ref":"#/components/schemas/request-type-request-settings-mutable"},"approvalSettings":{"$ref":"#/components/schemas/request-type-approval-settings-mutable"},"accessDuration":{"$ref":"#/components/schemas/request-duration"}},"example":{"name":"salesforce-01","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"prompt":"What is the business justification?","required":true,"input":{"type":"TEXT"}}]}]},"resourceSettings":{"type":"GROUPS","targetResources":["00g1emaKYZTWRYYRRTSK"]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"prompt":"What is the business justification?","required":true,"input":{"type":"TEXT"}}]}}}},"components/schemas/request-type-resource-settings-custom":{"id":"components/schemas/request-type-resource-settings-custom","kind":"json-schema","title":"request-type-resource-settings-custom","data":{"type":"object","description":"Resource settings which cannot be represented in the API accurately. Often the case when lastUpdatedSource is 'WEB'.","required":["type"],"properties":{"type":{"type":"string","enum":["CUSTOM"]}}}},"components/schemas/request-type-resource-settings-readable":{"id":"components/schemas/request-type-resource-settings-readable","kind":"json-schema","title":"request-type-resource-settings-readable","data":{"type":"object","description":"Which resource(s) are requestable","oneOf":[{"$ref":"#/components/schemas/request-type-resource-settings-apps"},{"$ref":"#/components/schemas/request-type-resource-settings-groups"},{"$ref":"#/components/schemas/request-type-resource-settings-entitlement-bundles"},{"$ref":"#/components/schemas/request-type-resource-settings-custom"}],"required":["type"],"discriminator":{"propertyName":"type","mapping":{"APPS":"#/components/schemas/request-type-resource-settings-apps","GROUPS":"#/components/schemas/request-type-resource-settings-groups","ENTITLEMENT_BUNDLES":"#/components/schemas/request-type-resource-settings-entitlement-bundles","CUSTOM":"#/components/schemas/request-type-resource-settings-custom"}}}},"components/schemas/field-id":{"id":"components/schemas/field-id","kind":"json-schema","title":"field-id","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"read-only"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field is useful for specifying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requesterFieldValues"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when adding a request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The generated value is a UUID v4 from "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://www.ietf.org/rfc/rfc4122.txt"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"RFC4122"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"format":"uuid","maxLength":36,"minLength":36,"readOnly":true,"example":"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"}},"components/schemas/base-field-readable":{"id":"components/schemas/base-field-readable","kind":"json-schema","title":"base-field-readable","data":{"type":"object","required":["id"],"properties":{"id":{"$ref":"#/components/schemas/field-id"}}}},"components/schemas/base-field":{"id":"components/schemas/base-field","kind":"json-schema","title":"base-field","data":{"type":"object","description":"The field to use when prompting the user","allOf":[{"$ref":"#/components/schemas/base-field-writable"},{"$ref":"#/components/schemas/base-field-readable"}]}},"components/schemas/field-select":{"id":"components/schemas/field-select","kind":"json-schema","title":"field-select","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field"}],"description":"A select field","required":["id","type","options"],"properties":{"type":{"$ref":"#/components/schemas/field-select-type"},"options":{"$ref":"#/components/schemas/field-select-options"}}}},"components/schemas/field-text":{"id":"components/schemas/field-text","kind":"json-schema","title":"field-text","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field"}],"description":"A text field","required":["id","type"],"properties":{"type":{"$ref":"#/components/schemas/field-text-type"}}}},"components/schemas/field-date":{"id":"components/schemas/field-date","kind":"json-schema","title":"field-date","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field"}],"description":"A date field","required":["id","type"],"properties":{"type":{"$ref":"#/components/schemas/field-date-time-type"}}}},"components/schemas/field":{"id":"components/schemas/field","kind":"json-schema","title":"field","data":{"type":"object","description":"The field to use when prompting the user","oneOf":[{"$ref":"#/components/schemas/field-select"},{"$ref":"#/components/schemas/field-text"},{"$ref":"#/components/schemas/field-date"}],"discriminator":{"propertyName":"type","mapping":{"SELECT":"#/components/schemas/field-select","TEXT":"#/components/schemas/field-text","DATE-TIME":"#/components/schemas/field-date"}},"default":{"type":"TEXT","required":true}}},"components/schemas/fields":{"id":"components/schemas/fields","kind":"json-schema","title":"fields","data":{"type":"array","description":"A list of fields to gather input. The order of the fields in the array controls the order that the fields are presented to users.","default":[],"maxItems":5,"items":{"$ref":"#/components/schemas/field"}}},"components/schemas/request-type-requester-member-of":{"id":"components/schemas/request-type-requester-member-of","kind":"json-schema","title":"request-type-requester-member-of","data":{"type":"object","description":"A request where the requester that must be a member of a particular Okta Group.","required":["type","requesterMemberOf"],"properties":{"type":{"type":"string","enum":["MEMBER_OF"]},"requesterMemberOf":{"$ref":"#/components/schemas/member-of"},"requesterFields":{"$ref":"#/components/schemas/fields"}}}},"components/schemas/request-type-requester-everyone":{"id":"components/schemas/request-type-requester-everyone","kind":"json-schema","title":"request-type-requester-everyone","data":{"type":"object","description":"A request where the requester may be any Okta user in the Okta organization.","required":["type"],"properties":{"type":{"type":"string","enum":["EVERYONE"]},"requesterFields":{"$ref":"#/components/schemas/fields"}}}},"components/schemas/request-type-requester-custom":{"id":"components/schemas/request-type-requester-custom","kind":"json-schema","title":"request-type-requester-custom","data":{"type":"object","description":"Request settings which cannot be represented in the API accurately. Often the case when lastUpdatedSource is 'WEB'.","required":["type"],"properties":{"type":{"type":"string","enum":["CUSTOM"]}}}},"components/schemas/request-type-request-settings-readable":{"id":"components/schemas/request-type-request-settings-readable","kind":"json-schema","title":"request-type-request-settings-readable","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestSettings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" control:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which users can request access using this request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"What fields the user may or must fill out in order to request access."},"children":[]}]}]}]}],"default":{"type":"EVERYONE","requesterFields":[]},"oneOf":[{"$ref":"#/components/schemas/request-type-requester-member-of"},{"$ref":"#/components/schemas/request-type-requester-everyone"},{"$ref":"#/components/schemas/request-type-requester-custom"}],"discriminator":{"propertyName":"type","mapping":{"MEMBER_OF":"#/components/schemas/request-type-requester-member-of","EVERYONE":"#/components/schemas/request-type-requester-everyone","CUSTOM":"#/components/schemas/request-type-requester-custom"}}}},"components/schemas/request-type-approver-fields":{"id":"components/schemas/request-type-approver-fields","kind":"json-schema","title":"request-type-approver-fields","data":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of fields with which to gather input."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The order of field object controls the order with which the fields are presented to users."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Known limitation"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unlike requester fields, all approver fields are "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and may not be set as optional."},"children":[]}]}]}],"default":[],"maxItems":5,"items":{"$ref":"#/components/schemas/field"}}},"components/schemas/request-type-approval-member-of":{"id":"components/schemas/request-type-approval-member-of","kind":"json-schema","title":"request-type-approval-member-of","data":{"type":"object","description":"An approval when the approver must be a member of a particular Okta Group.","required":["approverType","approverMemberOf"],"properties":{"approverType":{"type":"string","enum":["MEMBER_OF"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverMemberOf":{"$ref":"#/components/schemas/member-of"},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields"}}}},"components/schemas/request-type-approval-user":{"id":"components/schemas/request-type-approval-user","kind":"json-schema","title":"request-type-approval-user","data":{"type":"object","description":"An approval when the approver must be a particular user.","required":["approverType","approverUserId"],"properties":{"approverType":{"type":"string","enum":["USER"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverUserId":{"$ref":"#/components/schemas/user-id"},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields"}}}},"components/schemas/request-type-approval-manager":{"id":"components/schemas/request-type-approval-manager","kind":"json-schema","title":"request-type-approval-manager","data":{"type":"object","description":"Specifying the approver must be the requester's manager","required":["approverType"],"properties":{"approverType":{"type":"string","enum":["MANAGER"]},"description":{"type":"string","minLength":1,"maxLength":250},"approverFields":{"$ref":"#/components/schemas/request-type-approver-fields"}}}},"components/schemas/request-type-approval-resource-owner":{"id":"components/schemas/request-type-approval-resource-owner","kind":"json-schema","title":"request-type-approval-resource-owner","data":{"type":"object","description":"Specifying the approver must be the resource owner","required":["approverType"],"properties":{"approverType":{"type":"string","enum":["RESOURCE_OWNER"]},"description":{"type":"string","minLength":1,"maxLength":250}}}},"components/schemas/request-type-approval":{"id":"components/schemas/request-type-approval","kind":"json-schema","title":"request-type-approval","data":{"type":"object","description":"request-type-approval-description.md","oneOf":[{"$ref":"#/components/schemas/request-type-approval-member-of"},{"$ref":"#/components/schemas/request-type-approval-user"},{"$ref":"#/components/schemas/request-type-approval-manager"},{"$ref":"#/components/schemas/request-type-approval-resource-owner"}],"discriminator":{"propertyName":"approverType","mapping":{"MEMBER_OF":"#/components/schemas/request-type-approval-member-of","USER":"#/components/schemas/request-type-approval-user","MANAGER":"#/components/schemas/request-type-approval-manager","RESOURCE_OWNER":"#/components/schemas/request-type-approval-resource-owner"}}}},"components/schemas/request-type-approvals":{"id":"components/schemas/request-type-approvals","kind":"json-schema","title":"request-type-approvals","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SERIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" approvals required to grant access:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All specified approvals are considered required in order to fulfill an access request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one approval must be specified for a request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a request type has two approvals:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the first approval is immediately actionable by an approver in the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"After an approver has made a decision for the first approval, then the second approval is actionable."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The approval type of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"RESOURCE_OWNER"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported for apps, entitlement bundles, and associated groups from the resource requested."},"children":[]}]}]}]}],"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/request-type-approval"}}},"components/schemas/request-type-approval-settings-serial":{"id":"components/schemas/request-type-approval-settings-serial","kind":"json-schema","title":"request-type-approval-settings-serial","data":{"type":"object","description":"Settings for approval","required":["type","approvals"],"properties":{"type":{"type":"string","enum":["SERIAL"],"description":"When there are multiple approvals, an approval is not actionable until the previous approval has been approved. A denial will terminate the request and no subsequent approvals will be made actionable.\n"},"approvals":{"$ref":"#/components/schemas/request-type-approvals"}}}},"components/schemas/request-type-approval-settings-custom":{"id":"components/schemas/request-type-approval-settings-custom","kind":"json-schema","title":"request-type-approval-settings-custom","data":{"type":"object","description":"Approval settings which are not represented in the API accurately. Often the case when lastUpdatedSource is 'WEB'.","required":["type"],"properties":{"type":{"type":"string","enum":["CUSTOM"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CUSTOM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set for request types created through the Okta Access Requests app that aren't accurately represented by the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SERIAL"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request type model."},"children":[]}]}]}]}}}},"components/schemas/request-type-approval-settings-readable":{"id":"components/schemas/request-type-approval-settings-readable","kind":"json-schema","title":"request-type-approval-settings-readable","data":{"type":"object","description":"Approval settings for the request type","oneOf":[{"$ref":"#/components/schemas/request-type-approval-settings-serial"},{"$ref":"#/components/schemas/request-type-approval-settings-custom"},{"$ref":"#/components/schemas/request-type-approval-settings-none"}],"discriminator":{"propertyName":"type","mapping":{"SERIAL":"#/components/schemas/request-type-approval-settings-serial","CUSTOM":"#/components/schemas/request-type-approval-settings-custom","NONE":"#/components/schemas/request-type-approval-settings-none"}}}},"components/schemas/request-type-last-update-source":{"id":"components/schemas/request-type-last-update-source","kind":"json-schema","title":"request-type-last-update-source","data":{"type":"string","enum":["API","WEB"],"description":"Whether the request type was last updated through the API or the user interface."}},"components/schemas/request-type-full":{"id":"components/schemas/request-type-full","kind":"json-schema","title":"request-type-full","data":{"type":"object","description":"Full representation of a request type resource","allOf":[{"$ref":"#/components/schemas/writable-standard-properties"},{"$ref":"#/components/schemas/read-only-standard-properties"}],"required":["id","name","description","lastUpdated","lastUpdatedBy","ownerId","resourceSettings","requestSettings","approvalSettings","accessDuration","status","lastUpdateSource","_links"],"properties":{"ownerId":{"$ref":"#/components/schemas/request-type-owner-id"},"resourceSettings":{"$ref":"#/components/schemas/request-type-resource-settings-readable"},"requestSettings":{"$ref":"#/components/schemas/request-type-request-settings-readable"},"approvalSettings":{"$ref":"#/components/schemas/request-type-approval-settings-readable"},"accessDuration":{"$ref":"#/components/schemas/request-duration"},"status":{"$ref":"#/components/schemas/request-type-status"},"lastUpdateSource":{"$ref":"#/components/schemas/request-type-last-update-source"},"_links":{"$ref":"#/components/schemas/request-type-links"}},"example":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":["00g1emaKYZTWRYYRRTSK"]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"prompt":"What is the business justification?","required":true,"input":{"type":"TEXT"}}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"prompt":"What is the business justification?","required":true,"input":{"type":"TEXT"}}]}]},"lastUpdateSource":"API","status":"ACTIVE","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=0oa1gjh63g214q0Hq0g4","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb2db568c7c300079fefd0","type":"application/json"}}}}},"components/schemas/request-id":{"id":"components/schemas/request-id","kind":"json-schema","title":"request-id","data":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"request-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]}]}]}]}},"components/schemas/request-subject":{"id":"components/schemas/request-subject","kind":"json-schema","title":"request-subject","data":{"type":"string","description":"The subject of the request","maxLength":250,"minLength":1}},"components/schemas/requester-user-id":{"id":"components/schemas/requester-user-id","kind":"json-schema","title":"requester-user-id","data":{"type":"string","format":"okta-user-id","description":"Okta User.id of the requesting user","maxLength":20,"minLength":20,"pattern":"00u[0-9a-zA-Z]+"}},"components/schemas/requester-user-ids":{"id":"components/schemas/requester-user-ids","kind":"json-schema","title":"requester-user-ids","data":{"type":"array","minItems":1,"maxItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of requester Okta user "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"s."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/requester-user-id"}}},"components/schemas/request-mutable":{"id":"components/schemas/request-mutable","kind":"json-schema","title":"request-mutable","data":{"type":"object","description":"Properties which are mutable in mutation operations","properties":{"requestTypeId":{"$ref":"#/components/schemas/request-type-id"},"subject":{"$ref":"#/components/schemas/request-subject"},"requesterUserIds":{"$ref":"#/components/schemas/requester-user-ids"}},"example":{"subject":"Can I have access to Salesforce?","requestTypeId":"05ab2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"]}}},"components/schemas/request-request-status":{"id":"components/schemas/request-request-status","kind":"json-schema","title":"request-request-status","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request has a lifecycle. See our "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#request"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request lifecycle documentation"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request progresses in its lifecycle state based on requester, approver, and administrator activities across a variety of channels, such as:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access Request portal"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Slack"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Microsoft teams"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The following lifecycle operations are available on a single request."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/iga/openapi/governance-production-requests-admin-v1-reference/requests/createrequest"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Add"},"children":[]}]}]}]}]}],"enum":["OPEN","PENDING","RESOLVED","LOCKED"]}},"components/schemas/request-resolved-date-time":{"id":"components/schemas/request-resolved-date-time","kind":"json-schema","title":"request-resolved-date-time","data":{"type":"string","format":"date-time","nullable":true,"description":"The date the request was resolved. The property may transition from having a value to null if the request is reopened."}},"components/schemas/request-permalink-id":{"id":"components/schemas/request-permalink-id","kind":"json-schema","title":"request-permalink-id","data":{"type":"integer","description":"The immutable, persistent identifier that always resolves to the request"}},"components/schemas/request-links":{"id":"components/schemas/request-links","kind":"json-schema","title":"request-links","data":{"type":"object","description":"Links available on a single request representation","required":["requestType","self"],"properties":{"requestType":{"$ref":"#/components/schemas/link"},"self":{"$ref":"#/components/schemas/link"}},"additionalProperties":{"$ref":"#/components/schemas/link"}}},"components/schemas/request-sparse":{"id":"components/schemas/request-sparse","kind":"json-schema","title":"request-sparse","data":{"type":"object","description":"Sparse representation of a Request resource","allOf":[{"$ref":"#/components/schemas/read-only-standard-properties"},{"$ref":"#/components/schemas/request-mutable"}],"required":["id","createdBy","created","lastUpdated","lastUpdatedBy","subject","requestTypeId","type","resolved","requestStatus","requesterUserIds","permalinkId","_links"],"properties":{"type":{"description":"Whether the request's request type has CUSTOM settings or not.","type":"string","enum":["ACCESS_REQUEST","CUSTOM"]},"requestStatus":{"$ref":"#/components/schemas/request-request-status"},"resolved":{"$ref":"#/components/schemas/request-resolved-date-time"},"permalinkId":{"$ref":"#/components/schemas/request-permalink-id"},"_links":{"$ref":"#/components/schemas/request-links"}},"example":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","resolved":"2022-05-05T14:15:22Z'","requestStatus":"RESOLVED","type":"ACCESS_REQUEST","permalinkId":1,"_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}}}},"components/schemas/request-list-links":{"id":"components/schemas/request-list-links","kind":"json-schema","title":"request-list-links","data":{"type":"object","description":"Links available in request list response","required":["self"],"properties":{"self":{"$ref":"#/components/schemas/link"},"next":{"$ref":"#/components/schemas/link"}},"additionalProperties":{"$ref":"#/components/schemas/link"}}},"components/schemas/request-list":{"id":"components/schemas/request-list","kind":"json-schema","title":"request-list","data":{"type":"object","properties":{"data":{"description":"All requests on the current page","type":"array","items":{"$ref":"#/components/schemas/request-sparse"}},"_links":{"$ref":"#/components/schemas/request-list-links"}}}},"components/schemas/field-id-writable":{"id":"components/schemas/field-id-writable","kind":"json-schema","title":"field-id-writable","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requesterField"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the related request type's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestSettings.requesterFields"},"children":[]}]}]}],"format":"uuid","maxLength":36,"minLength":36,"example":"1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed"}},"components/schemas/field-date-time-value":{"id":"components/schemas/field-date-time-value","kind":"json-schema","title":"field-date-time-value","data":{"type":"string","nullable":true,"maxLength":1000,"format":"date-time","description":"Value provided by a user in ISO 8601 string format"}},"components/schemas/field-select-value-writable":{"id":"components/schemas/field-select-value-writable","kind":"json-schema","title":"field-select-value-writable","data":{"type":"array","nullable":true,"minItems":1,"maxItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Values provided by a user, only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported"},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/field-option-value"}}},"components/schemas/field-text-value":{"id":"components/schemas/field-text-value","kind":"json-schema","title":"field-text-value","data":{"type":"string","nullable":true,"minLength":1,"maxLength":1000,"description":"Value provided by a user"}},"components/schemas/field-value-writable-allowed-values":{"id":"components/schemas/field-value-writable-allowed-values","kind":"json-schema","title":"field-value-writable-allowed-values","data":{"anyOf":[{"$ref":"#/components/schemas/field-date-time-value"},{"$ref":"#/components/schemas/field-select-value-writable"},{"$ref":"#/components/schemas/field-text-value"}]}},"components/schemas/field-value-writable":{"id":"components/schemas/field-value-writable","kind":"json-schema","title":"field-value-writable","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"value"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" that corresponds to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of a field in the request type's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requestSettings.requesterFields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" corresponds to a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DATE-TIME"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the value must be an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ISO-8601"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" date-time."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" corresponds to a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"SELECT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the value must be an array of strings where each string is a value from the select field's options."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" corresponds to a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"TEXT"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field, the value must be a string."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only provide the field "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" once. Duplicates result in a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"409 Conflict"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A non-required field may be omitted from the list."},"children":[]}]}]}],"required":["id","value"],"properties":{"id":{"$ref":"#/components/schemas/field-id-writable"},"value":{"$ref":"#/components/schemas/field-value-writable-allowed-values"}}}},"components/schemas/requester-field-values-writable":{"id":"components/schemas/requester-field-values-writable","kind":"json-schema","title":"requester-field-values-writable","data":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field values provided when adding the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a request type has required "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requesterFields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", they must be provided when the request is created."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Non-required fields may be omitted when creating the request."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/field-value-writable"}}},"components/schemas/request-creatable-only":{"id":"components/schemas/request-creatable-only","kind":"json-schema","title":"request-creatable-only","data":{"type":"object","properties":{"requesterFieldValues":{"$ref":"#/components/schemas/requester-field-values-writable"}}}},"components/schemas/request-creatable":{"id":"components/schemas/request-creatable","kind":"json-schema","title":"request-creatable","data":{"type":"object","description":"The properties expected in an initial create request","required":["requestTypeId","subject"],"allOf":[{"$ref":"#/components/schemas/request-mutable"},{"$ref":"#/components/schemas/request-creatable-only"}],"example":{"subject":"Requesting access to salesforce-01 for my team member","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"]}}},"components/schemas/request-full-api-compatible":{"id":"components/schemas/request-full-api-compatible","kind":"json-schema","title":"request-full-api-compatible","data":{"type":"object","description":"Full representation of a Request resource.","allOf":[{"$ref":"#/components/schemas/read-only-standard-properties"},{"$ref":"#/components/schemas/request-mutable"},{"$ref":"#/components/schemas/request-minimal-read-only-fields"}],"required":["type","id","created","createdBy","subject","requestTypeId","lastUpdated","lastUpdatedBy","resolved","requestStatus","requesterUserIds","requesterFieldValues","approvals","actions","permalinkId","_links"],"properties":{"approvals":{"type":"array","description":"Request approvals","items":{"$ref":"#/components/schemas/request-approval"}},"actions":{"$ref":"#/components/schemas/request-actions"},"permalinkId":{"$ref":"#/components/schemas/request-permalink-id"},"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This request is associated with a request type with no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CUSTOM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings."},"children":[]}]}]}],"type":"string","enum":["ACCESS_REQUEST"]}}}},"components/schemas/request-full-api-incompatible":{"id":"components/schemas/request-full-api-incompatible","kind":"json-schema","title":"request-full-api-incompatible","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Request where the request type has a CUSTOM setting. This representation is limited and does not contain "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"actions"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"approvals"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/read-only-standard-properties"},{"$ref":"#/components/schemas/request-mutable"},{"$ref":"#/components/schemas/request-minimal-read-only-fields"}],"required":["type","id","created","createdBy","subject","requestTypeId","lastUpdated","lastUpdatedBy","resolved","requestStatus","requesterUserIds","requesterFieldValues","permalinkId","_links"],"properties":{"permalinkId":{"$ref":"#/components/schemas/request-permalink-id"},"type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This request is associated with a request type with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"CUSTOM"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings."},"children":[]}]}]}],"type":"string","enum":["CUSTOM"]}}}},"components/schemas/request-request-type-id":{"id":"components/schemas/request-request-type-id","kind":"json-schema","title":"request-request-type-id","data":{"type":"string","description":"The Request Type enabling this Request.","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"request-type-id","example":"05ab2db568c7c300079fefd0"}},"components/schemas/base-field-value":{"id":"components/schemas/base-field-value","kind":"json-schema","title":"base-field-value","data":{"type":"object","description":"The field value provided by the user","required":["required","prompt","id"],"properties":{"id":{"$ref":"#/components/schemas/field-id"},"prompt":{"$ref":"#/components/schemas/field-prompt"},"required":{"$ref":"#/components/schemas/field-required"}}}},"components/schemas/field-value-date":{"id":"components/schemas/field-value-date","kind":"json-schema","title":"field-value-date","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-value"}],"required":["id","type","value"],"properties":{"type":{"$ref":"#/components/schemas/field-date-time-type"},"value":{"$ref":"#/components/schemas/field-date-time-value"}}}},"components/schemas/field-select-value":{"id":"components/schemas/field-select-value","kind":"json-schema","title":"field-select-value","data":{"type":"array","nullable":true,"minItems":1,"maxItems":1,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Values provided by a user, only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is supported"},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/field-option-value"}}},"components/schemas/field-value-select":{"id":"components/schemas/field-value-select","kind":"json-schema","title":"field-value-select","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-value"}],"required":["id","type","value"],"properties":{"type":{"$ref":"#/components/schemas/field-select-type"},"value":{"$ref":"#/components/schemas/field-select-value"}},"example":{"type":"SELECT","prompt":"Indicate business justification","value":["REQUIRED for job duties"]}}},"components/schemas/field-value-text":{"id":"components/schemas/field-value-text","kind":"json-schema","title":"field-value-text","data":{"type":"object","allOf":[{"$ref":"#/components/schemas/base-field-value"}],"required":["id","type","value"],"properties":{"type":{"$ref":"#/components/schemas/field-text-type"},"value":{"$ref":"#/components/schemas/field-text-value"}}}},"components/schemas/field-value":{"id":"components/schemas/field-value","kind":"json-schema","title":"field-value","data":{"description":"The field value provided by the user","oneOf":[{"$ref":"#/components/schemas/field-value-date"},{"$ref":"#/components/schemas/field-value-select"},{"$ref":"#/components/schemas/field-value-text"}],"discriminator":{"propertyName":"type","mapping":{"DATE-TIME":"#/components/schemas/field-value-date","SELECT":"#/components/schemas/field-value-select","TEXT":"#/components/schemas/field-value-text"}}}},"components/schemas/requester-field-values":{"id":"components/schemas/requester-field-values","kind":"json-schema","title":"requester-field-values","data":{"type":"array","nullable":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field values provided when adding the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a request type has required "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"requesterFields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", they must be provided when the request is created."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Non-required fields may be omitted when creating the request."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/field-value"}}},"components/schemas/request-minimal-read-only-fields":{"id":"components/schemas/request-minimal-read-only-fields","kind":"json-schema","title":"request-minimal-read-only-fields","data":{"type":"object","description":"Properties contained by default in sparse representation","properties":{"requestStatus":{"$ref":"#/components/schemas/request-request-status"},"requestTypeId":{"$ref":"#/components/schemas/request-request-type-id"},"resolved":{"$ref":"#/components/schemas/request-resolved-date-time"},"requesterFieldValues":{"$ref":"#/components/schemas/requester-field-values"},"_links":{"$ref":"#/components/schemas/request-links"}}}},"components/schemas/request-approval-id":{"id":"components/schemas/request-approval-id","kind":"json-schema","title":"request-approval-id","data":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"approval-id","description":"A unique identifier of the approval in the request"}},"components/schemas/request-approval-pending":{"id":"components/schemas/request-approval-pending","kind":"json-schema","title":"request-approval-pending","data":{"type":"object","description":"A pending access request approval","required":["status","approvalId"],"properties":{"status":{"type":"string","description":"The status of a pending approval","enum":["PENDING"]},"approvalId":{"$ref":"#/components/schemas/request-approval-id"}},"example":{"requestStatus":"OPEN"}}},"components/schemas/approval-field-values":{"id":"components/schemas/approval-field-values","kind":"json-schema","title":"approval-field-values","data":{"type":"array","description":"Values to field prompts provided by the approver at the time of approval.\n\nAll approval fields specified in the related request type are represented in the same order as defined in the request type.","nullable":true,"items":{"$ref":"#/components/schemas/field-value"}}},"components/schemas/request-approval-completed":{"id":"components/schemas/request-approval-completed","kind":"json-schema","title":"request-approval-completed","data":{"type":"object","description":"A completed access request approval","required":["status","approverName","approvalId","approverId","decision","decided","fieldValues"],"properties":{"status":{"type":"string","description":"The status of a completed approval","enum":["COMPLETED"]},"approverName":{"type":"string","description":"Okta username of the user which approved the request","maxLength":100},"approvalId":{"$ref":"#/components/schemas/request-approval-id"},"approverId":{"type":"string","format":"okta-user-id","description":"Okta User.id of the user which approved the request","maxLength":20,"minLength":20,"pattern":"00u[0-9a-zA-Z]+"},"decision":{"type":"string","enum":["APPROVED","DENIED"]},"decided":{"type":"string","format":"date-time","description":"The date the approver made their decision."},"originalDeciderId":{"$ref":"#/components/schemas/user-id"},"originalDeciderFullName":{"type":"string","description":"Full name of the original decider","maxLength":100},"originalDeciderEmail":{"type":"string","description":"Email of the original decider","format":"email"},"deciderDelegated":{"type":"boolean","description":"Indicates if the decision was made by a delegated decider"},"deciderEscalated":{"type":"boolean","description":"Indicates if the decision was made by an escalated decider"},"fieldValues":{"$ref":"#/components/schemas/approval-field-values"}},"example":{"status":"COMPLETED","approverId":"00ub0oNGTSWTBKOLGLNR","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"type":"SELECT","value":[{"value":"Curious"}]}]}}},"components/schemas/request-approval":{"id":"components/schemas/request-approval","kind":"json-schema","title":"request-approval","data":{"type":"object","description":"An approval for this request. It may be in a PENDING or COMPLETED state.","oneOf":[{"$ref":"#/components/schemas/request-approval-pending"},{"$ref":"#/components/schemas/request-approval-completed"}],"discriminator":{"propertyName":"status","mapping":{"PENDING":"#/components/schemas/request-approval-pending","COMPLETED":"#/components/schemas/request-approval-completed"}}}},"components/schemas/request-action-enum":{"id":"components/schemas/request-action-enum","kind":"json-schema","title":"request-action-enum","data":{"type":"string","enum":["ADD_USER_TO_GROUP","ASSIGN_APP_TO_USER","GRANT_ACCESS_TO_ENTITLEMENT_BUNDLE"],"description":"The type of action taken by the access request service to fulfill the request."}},"components/schemas/request-action-id":{"id":"components/schemas/request-action-id","kind":"json-schema","title":"request-action-id","data":{"type":"string","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"action-id","description":"A unique identifier of the action taken in the request"}},"components/schemas/request-action-pending":{"id":"components/schemas/request-action-pending","kind":"json-schema","title":"request-action-pending","data":{"type":"object","description":"A pending action, approvals still required","required":["status","action","actionId"],"properties":{"status":{"type":"string","description":"The status of a pending action","enum":["PENDING"]},"action":{"$ref":"#/components/schemas/request-action-enum"},"actionId":{"$ref":"#/components/schemas/request-action-id"}},"example":{"status":"PENDING"}}},"components/schemas/resource-id":{"id":"components/schemas/resource-id","kind":"json-schema","title":"resource-id","data":{"type":"string","format":"okta-resource-id","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Okta "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"app.id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"group.id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of the resource that can be requested with this request type."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/management/tags/application/other/listapplications"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all applications"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve app IDs."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/api/openapi/okta-management/management/tags/group/other/listgroups"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List all groups"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to retrieve group IDs."},"children":[]}]}]}]}],"maxLength":20}},"components/schemas/okta-resource-readable":{"id":"components/schemas/okta-resource-readable","kind":"json-schema","title":"okta-resource-readable","data":{"type":"object","description":"Identifies a unique Okta resource","properties":{"resourceName":{"type":"string","description":"Human readable name of the resource"},"resourceId":{"$ref":"#/components/schemas/resource-id"},"resourceType":{"type":"string","enum":["APP","GROUP","ENTITLEMENT_BUNDLE"],"description":"The type of resource"}}}},"components/schemas/request-action-completed":{"id":"components/schemas/request-action-completed","kind":"json-schema","title":"request-action-completed","data":{"type":"object","description":"A completed access request approval","required":["status","action","actionId","actionStatus","actionAttempted","resourceId","resourceName","resourceType"],"allOf":[{"$ref":"#/components/schemas/okta-resource-readable"}],"properties":{"status":{"type":"string","description":"The status of a completed approval","enum":["COMPLETED"]},"action":{"$ref":"#/components/schemas/request-action-enum"},"actionId":{"$ref":"#/components/schemas/request-action-id"},"actionStatus":{"type":"string","enum":["SUCCEEDED","FAILED"],"description":"Whether the action was successful or not"},"actionAttempted":{"type":"string","format":"date-time","description":"When the action was attempted"},"accessRemoved":{"nullable":true,"type":"string","format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When access was removed if the associated Request Type has an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accessDuration"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". null if the Request Type does not have an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"accessDuration"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or the duration has not yet expired."},"children":[]}]}]}]}}}},"components/schemas/request-action":{"id":"components/schemas/request-action","kind":"json-schema","title":"request-action","data":{"type":"object","description":"An action taken as part of this request, null if there will never be actions for this request.","oneOf":[{"$ref":"#/components/schemas/request-action-pending"},{"$ref":"#/components/schemas/request-action-completed"}],"discriminator":{"propertyName":"status","mapping":{"PENDING":"#/components/schemas/request-action-pending","COMPLETED":"#/components/schemas/request-action-completed"}}}},"components/schemas/request-actions":{"id":"components/schemas/request-actions","kind":"json-schema","title":"request-actions","data":{"type":"array","minItems":1,"maxItems":1,"description":"A list of actions. Currently only supports one action per request.","nullable":true,"items":{"$ref":"#/components/schemas/request-action"}}},"components/schemas/request-full":{"id":"components/schemas/request-full","kind":"json-schema","title":"request-full","data":{"type":"object","description":"A full representation of a request","discriminator":{"propertyName":"type","mapping":{"ACCESS_REQUEST":"#/components/schemas/request-full-api-compatible","CUSTOM":"#/components/schemas/request-full-api-incompatible"}},"oneOf":[{"$ref":"#/components/schemas/request-full-api-compatible"},{"$ref":"#/components/schemas/request-full-api-incompatible"}]}},"components/schemas/request-message-message":{"id":"components/schemas/request-message-message","kind":"json-schema","title":"request-message-message","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Message that will be created for the request. Newline can be specified by characters \"\\n\". Message will be visible for all users who can view the request."},"children":[]}]}]}],"minLength":1,"maxLength":5000,"nullable":false}},"components/schemas/request-message-mutable":{"id":"components/schemas/request-message-mutable","kind":"json-schema","title":"request-message-mutable","data":{"type":"object","required":["message"],"properties":{"message":{"$ref":"#/components/schemas/request-message-message"}}}},"components/schemas/request-message-creatable":{"id":"components/schemas/request-message-creatable","kind":"json-schema","title":"request-message-creatable","data":{"type":"object","description":"The properties expected in a request message create request","allOf":[{"$ref":"#/components/schemas/request-message-mutable"}]}},"components/schemas/team-id":{"id":"components/schemas/team-id","kind":"json-schema","title":"team-id","data":{"type":"string","description":"Team ID","maxLength":24,"minLength":24,"pattern":"^[a-fA-F\\d]{24}$","format":"owner-id"}},"components/schemas/team-name":{"id":"components/schemas/team-name","kind":"json-schema","title":"team-name","data":{"type":"string","description":"The name of the team","maxLength":40,"minLength":1}},"components/schemas/team":{"id":"components/schemas/team","kind":"json-schema","title":"team","data":{"type":"object","required":["id","created","lastUpdated","name"],"properties":{"id":{"$ref":"#/components/schemas/team-id"},"created":{"description":"The ISO 8601 formatted date and time when the resource was created","type":"string","format":"date-time","readOnly":true},"lastUpdated":{"$ref":"#/components/schemas/last-updated"},"name":{"$ref":"#/components/schemas/team-name"}}}},"components/schemas/teams-list-links":{"id":"components/schemas/teams-list-links","kind":"json-schema","title":"teams-list-links","data":{"type":"object","description":"Links available in teams response","required":["self"],"properties":{"self":{"$ref":"#/components/schemas/link"},"next":{"$ref":"#/components/schemas/link"}},"additionalProperties":{"$ref":"#/components/schemas/link"}}},"components/schemas/teams-list":{"id":"components/schemas/teams-list","kind":"json-schema","title":"teams-list","data":{"type":"object","properties":{"data":{"description":"All teams on the current page","type":"array","items":{"$ref":"#/components/schemas/team"}},"_links":{"$ref":"#/components/schemas/teams-list-links"}}}},"schema_1416":{"kind":"json-schema","data":{"type":"object","properties":{"X-Rate-Limit-Limit":{"type":"integer","minimum":1,"example":60,"description":"The rate-limit ceiling for the current request"},"X-Rate-Limit-Remaining":{"type":"integer","minimum":0,"example":60,"description":"The number of requests left for the current rate-limit window"},"X-Rate-Limit-Reset":{"type":"integer","minimum":0,"example":1609459200,"description":"The time when the rate limit resets, specified in UTC epoch time (in seconds)"}},"required":["X-Rate-Limit-Limit","X-Rate-Limit-Remaining","X-Rate-Limit-Reset"]},"id":"schema_1416"},"schema_1417":{"kind":"json-schema","data":{"$ref":"#/components/schemas/scim-filter"},"id":"schema_1417"},"schema_1418":{"kind":"json-schema","data":{"$ref":"#/components/schemas/request-type-id"},"id":"schema_1418"},"schema_1419":{"kind":"json-schema","data":{"type":"integer","default":20,"maximum":200,"minimum":1},"id":"schema_1419"},"schema_1420":{"kind":"json-schema","data":{"$ref":"#/components/schemas/order-by"},"id":"schema_1420"},"schema_1421":{"kind":"json-schema","data":{"type":"object","properties":{"Link":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there's another page of results."},"children":[]}]}]}]}]},"X-Rate-Limit-Limit":{"type":"integer","minimum":1,"example":60,"description":"The rate-limit ceiling for the current request"},"X-Rate-Limit-Remaining":{"type":"integer","minimum":0,"example":60,"description":"The number of requests left for the current rate-limit window"},"X-Rate-Limit-Reset":{"type":"integer","minimum":0,"example":1609459200,"description":"The time when the rate limit resets, specified in UTC epoch time (in seconds)"}},"required":["X-Rate-Limit-Limit","X-Rate-Limit-Remaining","X-Rate-Limit-Reset"]},"id":"schema_1421"},"schema_1422":{"kind":"json-schema","data":{"$ref":"#/components/schemas/team-id"},"id":"schema_1422"},"schema_1423":{"kind":"json-schema","data":{"type":"object","properties":{"Link":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A link to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"self"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"blockquote","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"next"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is only present if there's another page of results."},"children":[]}]}]}]}]}}},"id":"schema_1423"},"schema_1424":{"kind":"json-schema","data":{"$ref":"#/components/schemas/request-id"},"id":"schema_1424"}},"exampleStore":{"components/examples/request-types-list-no-filter":{"id":"components/examples/request-types-list-no-filter","value":{"data":[{"id":"08ab2db568c7c300079fefd","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},{"id":"10ab2db568c7c300079fefd","name":"salesforce-01-request-type-07","description":"How anyone can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=10ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2210ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/10ab2db568c7c300079fefd0"}}},{"id":"07ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-01","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=07ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2207ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/07ab2db568c7c300079fefd0"}}},{"id":"01ab2db568c7c300079fefd0","name":"salesforce-01-request-type-01","description":"How users can get manager's approval to access Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=01ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2201ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/01ab2db568c7c300079fefd0"}}},{"id":"04ab2db568c7c300079fefd0","name":"salesforce-01-request-type-04","description":"How users can request access to Salesforce 01, approving manager must select justification","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=04ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2204ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/04ab2db568c7c300079fefd0"}}},{"id":"03ab2db568c7c300079fefd0","name":"salesforce-01-request-type-03","description":"How users can request access to Salesforce 01 and provide text input","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=03ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2203ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/03ab2db568c7c300079fefd0"}}},{"id":"05ab2db568c7c300079fefd0","name":"salesforce-01-request-type-05","description":"How users can request access to Salesforce 01, approving manager must approve and answer a question using a DATE-TIME field","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=05ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2205ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/05ab2db568c7c300079fefd0"}}},{"id":"06ab2db568c7c300079fefd0","name":"admin-group-01-request-type-01","description":"How users can request access to Admin Group 01, with multiple approvals, where each approval demonstrates a different way to specify the approver.","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=06ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2206ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/06ab2db568c7c300079fefd0"}}},{"id":"09ab2db568c7c300079fefd0","name":"salesforce-01-request-type-06","description":"How users can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=09ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2209ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/09ab2db568c7c300079fefd0"}}},{"id":"12ab2db568c7c300079fefd0","name":"salesforce-01-request-type-09","description":"How group members can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=12ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2212ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/12ab2db568c7c300079fefd0"}}}],"_links":{"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types?limit=20"}}},"summary":"List request types response with no filter","description":"A list of request type with no filter"},"components/examples/empty-after":{"id":"components/examples/empty-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Empty value found for query parameter 'after'","reason":"EMPTY_PARAMETER","locationType":"query","location":"/after","domain":"governance"}]},"summary":"Empty `after` parameter error response"},"components/examples/request-types-list-bad-request-invalid-after":{"id":"components/examples/request-types-list-bad-request-invalid-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a request type id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"summary":"When after parameter is invalid format"},"components/examples/request-types-list-bad-request-not-exist-after":{"id":"components/examples/request-types-list-bad-request-not-exist-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"summary":"When after parameter value not found","description":"When a request contains after query parameter with request type ID that does not exist"},"components/examples/invalid-sort":{"id":"components/examples/invalid-sort","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Invalid `orderBy` syntax","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/orderBy","domain":"governance"}]},"summary":"Invalid `orderBy` parameter error response"},"components/examples/invalid-limit":{"id":"components/examples/invalid-limit","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"The `limit` parameter isn't valid.","reason":"INVALID_DATA_TYPE","locationType":"query","location":"/limit","domain":"governance"}]},"summary":"Invalid `limit` parameter error response"},"components/examples/request-type-creatable-00-minimal-example":{"id":"components/examples/request-type-creatable-00-minimal-example","value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"For access to group, has minimal required properties","description":"The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager."},"components/examples/request-type-creatable-01-request-anyone-no-questions-example":{"id":"components/examples/request-type-creatable-01-request-anyone-no-questions-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"For access to app, includes defaults","description":"When request type is for access to app and includes defaults"},"components/examples/request-type-creatable-02-group-manager-example":{"id":"components/examples/request-type-creatable-02-group-manager-example","value":{"name":"admin-group-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"For access to group, requires manager's approval","description":"Creating a request type to enable requests for access to a group"},"components/examples/request-type-creatable-03-app-manager-example":{"id":"components/examples/request-type-creatable-03-app-manager-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"For access to app, manager's approval required","description":"Creating a request type to enable requests for access to an application"},"components/examples/request-type-creatable-04-app-manager-select-field-example":{"id":"components/examples/request-type-creatable-04-app-manager-select-field-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What is the justification for granting access?","required":true,"type":"SELECT","options":[{"value":"Required to perform job duties"},{"value":"Required to perform one time task"}]}]}]}},"summary":"Approver fields with select input","description":"Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option."},"components/examples/request-type-creatable-05-app-manager-text-field-example":{"id":"components/examples/request-type-creatable-05-app-manager-text-field-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What is the business justification for your employee's access?","required":true,"type":"TEXT"}]}]}},"summary":"Manager approver field specifies text defaults explicitly","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field."},"components/examples/request-type-creatable-06-app-manager-datetime-field-example":{"id":"components/examples/request-type-creatable-06-app-manager-datetime-field-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What time should access be revoked?","required":true,"type":"DATE-TIME"}]}]}},"summary":"Manager approver has required date-time field","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field."},"components/examples/request-type-creatable-07-approval-multi-step-example":{"id":"components/examples/request-type-creatable-07-approval-multi-step-example","value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"},{"approverType":"MEMBER_OF","approverMemberOf":["00garwpuyxHaWOkdV0g4"]},{"approverType":"USER","approverUserId":"00ub0oNGTSWTBKOLGLNR"}]}},"summary":"Multi-step approvals, one of each type","description":"Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required."},"components/examples/request-type-creatable-08-optional-questions-example":{"id":"components/examples/request-type-creatable-08-optional-questions-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"prompt":"Why are you requesting access?","type":"TEXT","required":false}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"Why are you approving access?","type":"TEXT","required":true}]}]}},"summary":"Optional requester field"},"components/examples/request-type-creatable-09-requester-memberof-example":{"id":"components/examples/request-type-creatable-09-requester-memberof-example","value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"MEMBER_OF","requesterMemberOf":["00garwpuyxHaWOkdV0g4"],"requesterFields":[{"prompt":"What is the business justification for access?","type":"TEXT","required":true}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"Requester must be member of a group","description":"Creating a request type where only members of a group may request access to the application."},"components/examples/request-type-creatable-10-active-example":{"id":"components/examples/request-type-creatable-10-active-example","value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","status":"ACTIVE","accessDuration":"P40D","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"summary":"An active request type with time bound access","description":"A request type created with active status where all requests will only grant access for a limited duration of time."},"components/examples/request-type-creatable-11-no-approval-example":{"id":"components/examples/request-type-creatable-11-no-approval-example","value":{"name":"Request for Grammarly","description":"A request type that allows a user to request access to Grammarly","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"NONE"}},"summary":"A request type that requires no approval","description":"Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n"},"components/examples/request-type-creatable-12-approval-description-example":{"id":"components/examples/request-type-creatable-12-approval-description-example","value":{"name":"Request for Tableau","description":"A request type that allows a user to request access to Tableau","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"USER","description":"Approval from Data Analytics Team Head - Stan Lee","approverUserId":"00ub0oNGTSWTBKOLGLNR"}]}},"summary":"A request type requiring an approval that has a description","description":"Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n"},"components/examples/request-type-creatable-13-resource-owner-approval-example":{"id":"components/examples/request-type-creatable-13-resource-owner-approval-example","value":{"name":"Request for Group","description":"A request type that requires approval from the owner of the group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"RESOURCE_OWNER"}]}},"summary":"A request type requiring resource owner approval","description":"Create a request type that requires approval from the owner of the resource\n"},"components/examples/request-type-creatable-00-minimal-full-example":{"id":"components/examples/request-type-creatable-00-minimal-full-example","value":{"id":"08ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"summary":"When request type is for groups, has minimal required properties","description":"The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager."},"components/examples/request-type-creatable-01-request-anyone-no-questions-full-example":{"id":"components/examples/request-type-creatable-01-request-anyone-no-questions-full-example","value":{"id":"10ab2db568c7c300079fefd0","name":"salesforce-01-request-type-07","description":"How anyone can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=10ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2210ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/10ab2db568c7c300079fefd0"}}},"summary":"For access to app, includes defaults","description":"Creating a request type and anyone may request it and not using default."},"components/examples/request-type-creatable-02-group-manager-full-example":{"id":"components/examples/request-type-creatable-02-group-manager-full-example","value":{"id":"07ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-01","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=07ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2207ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/07ab2db568c7c300079fefd0"}}},"summary":"For access to group, manager's approval required","description":"Creating a request type to enable requests for access to a group"},"components/examples/request-type-creatable-03-app-manager-full-example":{"id":"components/examples/request-type-creatable-03-app-manager-full-example","value":{"id":"01ab2db568c7c300079fefd0","name":"salesforce-01-request-type-01","description":"How users can get manager's approval to access Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=01ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2201ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/01ab2db568c7c300079fefd0"}}},"summary":"For access to app, manager's approval required","description":"Creating a request type to enable requests for access to an application"},"components/examples/request-type-creatable-04-app-manager-select-field-full-example":{"id":"components/examples/request-type-creatable-04-app-manager-select-field-full-example","value":{"id":"04ab2db568c7c300079fefd0","name":"salesforce-01-request-type-04","description":"How users can request access to Salesforce 01, approving manager must select justification","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the justification for granting access?","required":true,"type":"SELECT","options":[{"value":"Required to perform job duties"},{"value":"Required to perform one time task"}]}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=04ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2204ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/04ab2db568c7c300079fefd0"}}},"summary":"Manager approver has required select field","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and select an option."},"components/examples/request-type-creatable-05-app-manager-text-field-full-example":{"id":"components/examples/request-type-creatable-05-app-manager-text-field-full-example","value":{"id":"03ab2db568c7c300079fefd0","name":"salesforce-01-request-type-03","description":"How users can request access to Salesforce 01 and provide text input","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for your employee's access?","required":true,"type":"TEXT"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=03ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2203ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/03ab2db568c7c300079fefd0"}}},"summary":"Manager approver field specifies text defaults explicitly","description":"Full representation of approver text field"},"components/examples/request-type-creatable-06-app-manager-datetime-field-full-example":{"id":"components/examples/request-type-creatable-06-app-manager-datetime-field-full-example","value":{"id":"05ab2db568c7c300079fefd0","name":"salesforce-01-request-type-05","description":"How users can request access to Salesforce 01, approving manager must approve and answer a question using a DATE-TIME field","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What time should access be revoked?","required":true,"type":"DATE-TIME"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=05ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2205ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/05ab2db568c7c300079fefd0"}}},"summary":"Manager approver has required date-time field","description":"Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field."},"components/examples/request-type-creatable-07-approval-multi-step-full-example":{"id":"components/examples/request-type-creatable-07-approval-multi-step-full-example","value":{"id":"06ab2db568c7c300079fefd0","name":"admin-group-01-request-type-01","description":"How users can request access to Admin Group 01, with multiple approvals, where each approval demonstrates a different way to specify the approver.","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Admin Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]},{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00garwpuyxHaWOkdV0g4"],"approverFields":[]},{"approverType":"USER","description":"Approval from the specified user","approverUserId":"00ub0oNGTSWTBKOLGLNR","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=06ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2206ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/06ab2db568c7c300079fefd0"}}},"summary":"Multi-step approvals, one of each type","description":"Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve."},"components/examples/request-type-creatable-08-optional-questions-full-example":{"id":"components/examples/request-type-creatable-08-optional-questions-full-example","value":{"id":"09ab2db568c7c300079fefd0","name":"salesforce-01-request-type-06","description":"How users can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","type":"TEXT","prompt":"Why are you requesting access?","required":false}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"TEXT","prompt":"Why are you approving access?","required":true}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=09ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2209ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/09ab2db568c7c300079fefd0"}}},"summary":"Optional requester field"},"components/examples/request-type-creatable-09-requester-memberof-full-example":{"id":"components/examples/request-type-creatable-09-requester-memberof-full-example","value":{"id":"12ab2db568c7c300079fefd0","name":"salesforce-01-request-type-09","description":"How group members can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"MEMBER_OF","requesterMemberOf":["00garwpuyxHaWOkdV0g4"],"requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for access?","type":"TEXT","required":true}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=12ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2212ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/12ab2db568c7c300079fefd0"}}},"summary":"Requester must be member of a group","description":"Creating a request type where only members of a group may request access to the application."},"components/examples/request-type-creatable-10-active-full-example":{"id":"components/examples/request-type-creatable-10-active-full-example","value":{"id":"08ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":"P40D","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"summary":"An active request type with time bound access","description":"A request type created with active status where all requests will only grant access for a limited duration of time."},"components/examples/request-type-creatable-11-no-approval-full-example":{"id":"components/examples/request-type-creatable-11-no-approval-full-example","value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Grammarly","description":"A request type that allows a user to request access to Grammarly","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Grammarly"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"NONE"},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Grammarly&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"summary":"A request type that requires no approval","description":"Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n"},"components/examples/request-type-creatable-12-approval-description-full-example":{"id":"components/examples/request-type-creatable-12-approval-description-full-example","value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Tableau","description":"A request type that allows a user to request access to Tableau","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Tableau"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"USER","description":"Approval from Data Analytics Team Head - Stan Lee","approverUserId":"00ub0oNGTSWTBKOLGLNR","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Tableau&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"summary":"A request type requiring an approval that has a description","description":"Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n"},"components/examples/request-type-creatable-13-resource-owner-approval-full-example":{"id":"components/examples/request-type-creatable-13-resource-owner-approval-full-example","value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Group","description":"A request type that requires approval from the owner of the group","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"RESOURCE_OWNER","description":"Approval from the resource owner","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Group&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"summary":"A request type requiring resource owner approval","description":"Create a request type that requires approval from the owner of the resource\n"},"components/examples/requester-memberOf-invalid-group-id":{"id":"components/examples/requester-memberOf-invalid-group-id","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterMemberOf/0 00g1emaKYZTWRYYRRTWX not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"00g1emaKYZTWRYYRRTWX not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"body","location":"/requestSettings/requesterMemberOf/0","domain":"governance"}]},"summary":"When requesterMemberOf contains an not found Okta Group id","description":"When /requestSettings/requesterMemberOf/0 contains a groupId that is not discoverable in your Okta organization."},"components/examples/approval-memberOf-too-many-group-ids":{"id":"components/examples/approval-memberOf-too-many-group-ids","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals/0/approverMemberOf/0 must NOT have more than 1 items","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have more than 1 items","reason":"INVALID_ARRAY_LENGTH_OVER_MAX","locationType":"body","location":"/approvalSettings/approvals/0/approverMemberOf/0","domain":"governance"}]},"summary":"When too many Okta groupIds are included in approverMemberOf","description":"When too many Okta groupIds are included in /approvalSettings/approvals/0/approverMemberOf/0"},"components/examples/approval-missing-memberOf":{"id":"components/examples/approval-missing-memberOf","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterMemberOf must have required property 'requesterMemberOf'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'requesterMemberOf'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/requestSettings/requesterMemberOf","domain":"governance"}]},"summary":"When required /requestSettings/requesterMemberOf is missing","description":"When required /requestSettings/requesterMemberOf is missing"},"components/examples/fieldOptions-label-value-too-long":{"id":"components/examples/fieldOptions-label-value-too-long","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/options/0/value must NOT have more than 280 characters","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have more than 280 characters","reason":"INVALID_STRING_LENGTH_OVER_MAX","locationType":"body","location":"/requestSettings/requesterFields/0/options/0/value","domain":"governance"}]},"summary":"When SELECT option value exceeds max length","description":"When /requestSettings/requesterFields/0/options/0/value exceeds max length"},"components/examples/fieldOptions-missing":{"id":"components/examples/fieldOptions-missing","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/options must have required property 'options'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'options'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/requestSettings/requesterFields/0/options","domain":"governance"}]},"summary":"When SELECT options are missing","description":"When /requestSettings/requesterFields/0/options is missing"},"components/examples/approver-fields-type-invalid":{"id":"components/examples/approver-fields-type-invalid","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals/0/approverFields/0/ must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","reason":"INVALID_ENUM_VALUE","locationType":"body","location":"/approvalSettings/approvals/0/approverFields/0/type","domain":"governance"}]},"summary":"When approver field type is invalid","description":"When approver field type is invalid"},"components/examples/requester-fields-type-invalid":{"id":"components/examples/requester-fields-type-invalid","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/type must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","reason":"INVALID_ENUM_VALUE","locationType":"body","location":"/requestSettings/requesterFields/0/type","domain":"governance"}]},"summary":"When requester field type is invalid","description":"When requester field type is invalid"},"components/examples/no-approvals":{"id":"components/examples/no-approvals","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals must NOT have fewer than 1 items","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have fewer than 1 items","reason":"INVALID_ARRAY_LENGTH_UNDER_MIN","locationType":"body","location":"/approvalSettings/approvals","domain":"governance"}]},"description":"When approvals is empty array"},"components/examples/ownerId-invalid":{"id":"components/examples/ownerId-invalid","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: ownerId must be a Team in your organization.","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"ownerId must be a Team in your organization.","reason":"IDENTIFIER_NOT_FOUND","locationType":"body","location":"ownerId","domain":"governance"}]},"description":"When ownerId is invalid"},"components/examples/ownerId-missing":{"id":"components/examples/ownerId-missing","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'ownerId'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'ownerId'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/ownerId","domain":"governance"}]},"summary":"When ownerId is missing","description":"When /ownerId is missing"},"components/examples/request-settings-missing":{"id":"components/examples/request-settings-missing","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'requestSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'requestSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/","domain":"governance"}]},"summary":"When requestSettings is missing","description":"When /requestSettings is missing"},"components/examples/ownerId-and-settings-missing":{"id":"components/examples/ownerId-and-settings-missing","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'ownerId', must have required property 'resourceSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'ownerId'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/ownerId","domain":"governance"},{"errorSummary":"must have required property 'resourceSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/resourceSettings","domain":"governance"}]},"summary":"When ownerId and resourceSettings are missing","description":"When /ownerId /resourceSettings are missing"},"components/examples/approval-settings-missing":{"id":"components/examples/approval-settings-missing","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'approvalSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'approvalSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/","domain":"governance"}]},"summary":"When approvalSettings is missing","description":"When /approvalSettings is missing"},"components/examples/request-type-get-published":{"id":"components/examples/request-type-get-published","value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=0oa1gjh63g214q0Hq0g4","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"summary":"When getting a request type in published status","description":"When getting a request type in published status"},"components/examples/request-type-get-un-published":{"id":"components/examples/request-type-get-un-published","value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2019-08-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"summary":"When getting a request type in draft status","description":"When getting a request type in draft status"},"components/examples/request-type-get-incompatible-example":{"id":"components/examples/request-type-get-incompatible-example","value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"Request type created through WEB","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2019-08-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","resourceSettings":{"type":"CUSTOM"},"requestSettings":{"type":"CUSTOM"},"approvalSettings":{"type":"CUSTOM"},"ownerId":"61eb0f06c462d20007f051ac","status":"ACTIVE","lastUpdateSource":"WEB","accessDuration":null,"_links":{"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"}}},"summary":"When getting a custom request type","description":"When getting a custom request type"},"components/examples/request-type-publish-disabled-example":{"id":"components/examples/request-type-publish-disabled-example","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Cannot publish or unpublish a DISABLED request type. Repair the request type using the administrative user interface.","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"summary":"When attempting to publish a DISABLED request type","description":"When attempting to publish a DISABLED request type"},"components/examples/request-type-un-publish-disabled-example":{"id":"components/examples/request-type-un-publish-disabled-example","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Cannot publish or unpublish a DISABLED request type. Repair the request type using the administrative user interface.","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"summary":"When attempting to publish a DISABLED request type","description":"When attempting to publish a DISABLED request type"},"components/examples/requests-list-no-filter":{"id":"components/examples/requests-list-no-filter","value":{"data":[{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-24T14:15:22Z","requestStatus":"RESOLVED","type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":2,"resolved":null,"requestStatus":"OPEN","type":"CUSTOM","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}}],"_links":{"self":{"href":"https://myorg.okta.com/governance/api/v1/requests?limit=1"},"next":{"href":"https://myorg.okta.com/governance/api/v1/requests?limit=1&after=SDERDSDx00ub0oNGTSWTBKOLGLNR"}}},"summary":"List Request response with no filter","description":"A List Request response with no filter"},"components/examples/requests-list-bad-request-invalid-after":{"id":"components/examples/requests-list-bad-request-invalid-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a request id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"summary":"When after parameter is invalid format"},"components/examples/requests-list-bad-request-not-exist-after":{"id":"components/examples/requests-list-bad-request-not-exist-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"summary":"When after parameter value not found","description":"When a request contains after query parameter with request ID that does not exist"},"components/examples/request-00-create-no-requester-example":{"id":"components/examples/request-00-create-no-requester-example","value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce"},"summary":"When requesting for authenticated user"},"components/examples/request-01-create-requester-example":{"id":"components/examples/request-01-create-requester-example","value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce","requesterUserIds":["00uijntSwJjSHtDY70g3"]},"summary":"When requesting for non-authenticated user"},"components/examples/request-02-create-field-values-example":{"id":"components/examples/request-02-create-field-values-example","value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce","requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","value":"To fulfill my job duties"},{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","value":"2022-05-05T14:15:22Z"},{"id":"1c5ef673-8dbb-4b9c-ac76-0b4180116e43","value":["Salesforce"]}]},"summary":"When request type has required fields","description":"As an admin service account, request access for a user and provide required field values"},"components/examples/request-00-create-no-requester-example-full":{"id":"components/examples/request-00-create-no-requester-example-full","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When requesting for authenticated user"},"components/examples/request-01-create-requester-example-full":{"id":"components/examples/request-01-create-requester-example-full","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00uijntSwJjSHtDY70g3"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When requesting for non-authenticated user"},"components/examples/request-pending-requester-field-values-example":{"id":"components/examples/request-pending-requester-field-values-example","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","required":true,"value":null}],"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When request's request type has required requester fields","description":"When request's request type has required requester fields"},"components/examples/request-02-create-field-values-example-full":{"id":"components/examples/request-02-create-field-values-example-full","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00uijntSwJjSHtDY70g3"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","required":true,"type":"TEXT","prompt":"What is the business jutification?","value":"To fulfill my job duties"},{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","required":true,"type":"DATE-TIME","prompt":"When do you need access until?","value":"2022-05-05T14:15:22Z"},{"id":"1c5ef673-8dbb-4b9c-ac76-0b4180116e43","required":true,"type":"SELECT","prompt":"What do you need access to?","value":["Salesforce"]}],"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When request type has required fields"},"components/examples/request-pending-only-approval-example":{"id":"components/examples/request-pending-only-approval-example","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When request's request type has no requester fields, one approval required","description":"When request's request type has no requester fields, one approval required"},"components/examples/request-pending-all-approvals-example":{"id":"components/examples/request-pending-all-approvals-example","value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"When request's request type has no requester fields, many approvals required","description":"When request's request type has no requester fields, many approvals required"},"components/examples/requester-user-id-invalid-example":{"id":"components/examples/requester-user-id-invalid-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterUserIds/0 00u22uiKQa0xXkbdGLNR not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"00u22uiKQa0xXkbdGLNR not found","location":"/requesterUserIds/0","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"summary":"When a requester user id cannot be found","description":"Bad request response when a requesterUserId cannot be found."},"components/examples/request-type-not-found-example":{"id":"components/examples/request-type-not-found-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestTypeId 61eb2db568c7c300079fefd0 not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"61eb2db568c7c300079fefd0 not found","location":"/requestTypeId","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"summary":"When the request type cannot be found","description":"Bad request response when requestTypeId cannot be found."},"components/examples/request-field-id-missing-example":{"id":"components/examples/request-field-id-missing-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'id'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'id'","location":"/requesterFieldValues/0/id","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"summary":"When field id is not provided in fieldValues","description":"When the requesterFieldValues contains an item but no id is provided"},"components/examples/request-field-id-invalid-example":{"id":"components/examples/request-field-id-invalid-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/id must be uuid v4","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be uuid v4","location":"/requesterFieldValues/0/id","locationType":"body","reason":"STRING_FORMAT_INVALID"}]},"summary":"When field id in requesterFieldValues is invalid","description":"When the requesterFieldValues contains an item and the id is invalid"},"components/examples/request-field-id-not-found-example":{"id":"components/examples/request-field-id-not-found-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/id 05c87fe9-11f6-4d40-a033-b155b39dcdbe not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"05c87fe9-11f6-4d40-a033-b155b39dcdbe not found","location":"/requesterFieldValues/0/id","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"summary":"When field ID not found"},"components/examples/request-field-value-missing-example":{"id":"components/examples/request-field-value-missing-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'value'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'value'","location":"/requesterFieldValues/0/value","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"summary":"When field value is not provided in fieldValues","description":"When the requesterFieldValues contains an item but no value is provided"},"components/examples/request-field-value-invalid-example":{"id":"components/examples/request-field-value-invalid-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/value must be date-time","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be date-time","location":"/requesterFieldValues/0/value","locationType":"body","reason":"STRING_FORMAT_INVALID"}]},"summary":"When field value in requesterFieldValues is invalid","description":"When the requesterFieldValues contains an item and the value is invalid"},"components/examples/request-field-type-missing-example":{"id":"components/examples/request-field-type-missing-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'type'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'type'","location":"/requesterFieldValues/0/value","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"summary":"When field type is not provided in fieldValues","description":"When the requesterFieldValues contains an item but no type is provided"},"components/examples/request-field-type-invalid-example":{"id":"components/examples/request-field-type-invalid-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/type must be equal to one of the allowed values: TEXT, SELECT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be equal to one of the allowed values: TEXT, SELECT, DATE-TIME","location":"/requesterFieldValues/0/type","locationType":"body","reason":"INVALID_ENUM_VALUE"}]},"summary":"When field type in requesterFieldValues is invalid","description":"When the requesterFieldValues contains an item and the type is invalid"},"components/examples/request-create-authenticated-user-not-admin-example":{"id":"components/examples/request-create-authenticated-user-not-admin-example","value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action.","errorLink":"E0000006","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","reason":"INSUFFICIENT_PERMISSIONS","errorSummary":"Authenticated user must be a Super Admin or Access Request Admin."}]},"summary":"Authenticated user is not an admin","description":"Operation restricted to authenticated users with Super Admin or Access Request Admin role."},"components/examples/request-create-authenticated-user-not-member-of-example":{"id":"components/examples/request-create-authenticated-user-not-member-of-example","value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action.","errorLink":"E0000006","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Authenticated user and contents of /body/requesterUserIds must be members of the group specified in the request type's /requestSettings/requesterMemberOf array.","location":"/requesterUserIds","locationType":"body","reason":"REQUEST_TYPE_SETTINGS"}]},"summary":"Authenticated user not member of group in request settings","description":"When the request's request type specifies that the requester must be a member of a group in /requestSettings/requesterMemberOf, that restriction also applies to the authenticated user."},"components/examples/request-request-type-disabled-example":{"id":"components/examples/request-request-type-disabled-example","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DISABLED","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DISABLED","location":"/requestTypeId","locationType":"body","reason":"REQUEST_TYPE_STATE"}]},"summary":"When the request type in disabled status","description":"Conflict response when creating a request using a request type in disabled status."},"components/examples/request-request-type-draft-example":{"id":"components/examples/request-request-type-draft-example","value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DRAFT","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DRAFT","location":"/requestTypeId","locationType":"body","reason":"REQUEST_TYPE_STATE"}]},"summary":"When the request type in draft status","description":"Conflict response when creating a request using a request type in draft status."},"components/examples/request-required-field-missing-example":{"id":"components/examples/request-required-field-missing-example","value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues must have all required requesterFields","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have all required requesterFields","location":"/requesterFieldValues","locationType":"body","reason":"REQUEST_TYPE_SETTINGS"}]},"summary":"When request is missing required requester field","description":"When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"},"components/examples/request-get-fulfilled":{"id":"components/examples/request-get-fulfilled","value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","action":"ASSIGN_APP_TO_USER","actionId":"62f6d63a1764a30007763ad5","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"Resolved request with one approval","description":"Success response to get a Request"},"components/examples/request-get-pending-missing-one-approval":{"id":"components/examples/request-get-pending-missing-one-approval","value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z'","requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"Open request with requester and approver field values","description":"Two required approvals, but one still pending"},"components/examples/request-get-api-incompatible":{"id":"components/examples/request-get-api-incompatible","value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"type":"CUSTOM","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"Request using CUSTOM Request Type","description":"Success response for GET Request using CUSTOM Request Type"},"components/examples/request-get-access-duration-expired":{"id":"components/examples/request-get-access-duration-expired","value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","actionId":"62f6d63a1764a30007763ad5","action":"ASSIGN_APP_TO_USER","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","accessRemoved":"2022-06-12T21:36:25.344Z","resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"Time bound access, ten day access duration","description":"A request where access has been granted, and the accessDuration has expired."},"components/examples/request-get-access-duration-not-expired":{"id":"components/examples/request-get-access-duration-not-expired","value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","action":"ASSIGN_APP_TO_USER","actionId":"62f6d63a1764a30007763ad5","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","accessRemoved":null,"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"summary":"Time bound access, not yet expired","description":"A request where access has been granted, but it is time bounded and will be revoked in the future."},"components/examples/request-message-00-create-message-audience-all":{"id":"components/examples/request-message-00-create-message-audience-all","value":{"message":"Contact admin@atko.com for any additional assistance needed with this request."},"summary":"When creating a request message visible for everyone with access to the request","description":"Add request message for authenticated user visible to all"},"components/examples/request-message-01-create-message-referencing-another-system":{"id":"components/examples/request-message-01-create-message-referencing-another-system","value":{"message":"Find information about our access request policies here https://<company-internal-wiki-1>"},"summary":"When embedding a reference to another application","description":"Including a link to another system for an approver."},"components/examples/request-message-02-create-message-max-message-limit":{"id":"components/examples/request-message-02-create-message-max-message-limit","value":{"message":"This access created as part of Sally's onboarding packet. Please ensure you have review company guidelines on application access located at: - https://<company-internal-wiki-1> - https://<company-internal-wiki-2> - https://<company-internal-wiki-3> - https://<company-internal-wiki-5> - https://<company-internal-wiki-6> - https://<company-internal-wiki-7> - https://<company-internal-wiki-8> - https://<company-internal-wiki-9> - https://<company-internal-wiki-10> - https://<company-internal-wiki-11> - https://<company-internal-wiki-12> - https://<company-internal-wiki-13> - https://<company-internal-wiki-14> - https://<company-internal-wiki-15> - https://<company-internal-wiki-16> - https://<company-internal-wiki-17> - https://<company-internal-wiki-18> - https://<company-internal-wiki-19> - https://<company-internal-wiki-20> - https://<company-internal-wiki-21> - https://<company-internal-wiki-22> - https://<company-internal-wiki-23> - https://<company-internal-wiki-24> - https://<company-internal-wiki-25> - https://<company-internal-wiki-25> - https://<company-internal-wiki-27> - https://<company-internal-wiki-28> - https://<company-internal-wiki-29> - https://<company-internal-wiki-30> - https://<company-internal-wiki-31> - https://<company-internal-wiki-32> - https://<company-internal-wiki-34> - https://<company-internal-wiki-35> - https://<company-internal-wiki-36> - https://<company-internal-wiki-37> - https://<company-internal-wiki-38> - https://<company-internal-wiki-39> - https://<company-internal-wiki-40> - https://<company-internal-wiki-42> - https://<company-internal-wiki-43> - https://<company-internal-wiki-44> - https://<company-internal-wiki-45> - https://<company-internal-wiki-46> - https://<company-internal-wiki-47> - https://<company-internal-wiki-48> - https://<company-internal-wiki-49> - https://<company-internal-wiki-50> - https://<company-internal-wiki-51> - https://<company-internal-wiki-52> - https://<company-internal-wiki-53> - https://<company-internal-wiki-54> - https://<company-internal-wiki-55> - https://<company-internal-wiki-56> - https://<company-internal-wiki-57> - https://<company-internal-wiki-58> - https://<company-internal-wiki-59> - https://<company-internal-wiki-60> - https://<company-internal-wiki-61> - https://<company-internal-wiki-62> - https://<company-internal-wiki-63> - https://<company-internal-wiki-64> - https://<company-internal-wiki-65> - https://<company-internal-wiki-66> - https://<company-internal-wiki-67> - https://<company-internal-wiki-68> - https://<company-internal-wiki-69> - https://<company-internal-wiki-70> - https://<company-internal-wiki-71> - https://<company-internal-wiki-72> - https://<company-internal-wiki-73> - https://<company-internal-wiki-74> - https://<company-internal-wiki-75> - https://<company-internal-wiki-76> - https://<company-internal-wiki-77> - https://<company-internal-wiki-78> - https://<company-internal-wiki-79> - https://<company-internal-wiki-80> - https://<company-internal-wiki-81> - https://<company-internal-wiki-82> - https://<company-internal-wiki-83> - https://<company-internal-wiki-84> - https://<company-internal-wiki-85> - https://<company-internal-wiki-86> - https://<company-internal-wiki-87> - https://<company-internal-wiki-88> - https://<company-internal-wiki-89> - https://<company-internal-wiki-90> - https://<company-internal-wiki-91> - https://<company-internal-wiki-92> - https://<company-internal-wiki-93> - https://<company-internal-wiki-94> - https://<company-internal-wiki-95> - https://<company-internal-wiki-96> - https://<company-internal-wiki-97> - https://<company-internal-wiki-98> - https://<company-internal-wiki-99>"},"summary":"When creating a request message approaching the maximum length limit","description":"A very long message programmatically added to the request."},"components/examples/teams-list-no-filter":{"id":"components/examples/teams-list-no-filter","value":{"data":[{"id":"08ab2db568c7c300079fefd0","name":"Salesforce admins","created":"2022-05-24T14:15:22Z","lastUpdated":"2022-05-24T14:15:22Z"},{"id":"08ab2db568c7c300079fefd0","name":"Netsuite admins","created":"2022-05-24T14:15:22Z","lastUpdated":"2022-05-24T14:15:22Z"}]},"summary":"List teams","description":"A list of teams"},"components/examples/teams-list-bad-request-invalid-after":{"id":"components/examples/teams-list-bad-request-invalid-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a team id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"summary":"When after parameter is invalid format"},"components/examples/teams-list-bad-request-not-exist-after":{"id":"components/examples/teams-list-bad-request-not-exist-after","value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"summary":"When after parameter value not found","description":"When a request contains after query parameter with team ID that does not exist"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.":{"value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","summary":"For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","description":"The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","summary":"For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults","description":"When request type is for access to app and includes defaults","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, includes defaults |tooltip| When request type is for access to app and includes defaults"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group":{"value":{"name":"admin-group-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","summary":"For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group","description":"Creating a request type to enable requests for access to a group","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to group, requires manager's approval |tooltip| Creating a request type to enable requests for access to a group"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","summary":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","description":"Creating a request type to enable requests for access to an application","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What is the justification for granting access?","required":true,"type":"SELECT","options":[{"value":"Required to perform job duties"},{"value":"Required to perform one time task"}]}]}]}},"key":"Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","summary":"Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","description":"Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Approver fields with select input |tooltip| Creating a Request Type where anyone may request access. The requester's manager needs to approve and select an option."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What is the business justification for your employee's access?","required":true,"type":"TEXT"}]}]}},"key":"Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","summary":"Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for text field."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"What time should access be revoked?","required":true,"type":"DATE-TIME"}]}]}},"key":"Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","summary":"Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Manager approver has required date-time field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and must provide value for date-time field."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.":{"value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"},{"approverType":"MEMBER_OF","approverMemberOf":["00garwpuyxHaWOkdV0g4"]},{"approverType":"USER","approverUserId":"00ub0oNGTSWTBKOLGLNR"}]}},"key":"Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","summary":"Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","description":"Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating a request type with many approvals. Anyone can request access to the group. No questions need to be answered. First their manager's approval is required. Second a member of a group's approval is required. And finally a specific user's approval is required."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"prompt":"Why are you requesting access?","type":"TEXT","required":false}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","approverFields":[{"prompt":"Why are you approving access?","type":"TEXT","required":true}]}]}},"key":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","summary":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","description":"When a requester field is optional. **Note** approverFields always required if present.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.":{"value":{"name":"salesforce-01-request-type","description":"How users can request access to Salesforce 01","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"MEMBER_OF","requesterMemberOf":["00garwpuyxHaWOkdV0g4"],"requesterFields":[{"prompt":"What is the business justification for access?","type":"TEXT","required":true}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","summary":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","description":"Creating a request type where only members of a group may request access to the application.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.":{"value":{"name":"salesforce-01","description":"How users can request access to Admin Group","ownerId":"61eb0f06c462d20007f051ac","status":"ACTIVE","accessDuration":"P40D","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER"}]}},"key":"An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","summary":"An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","description":"A request type created with active status where all requests will only grant access for a limited duration of time.","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time."},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n":{"value":{"name":"Request for Grammarly","description":"A request type that allows a user to request access to Grammarly","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"NONE"}},"key":"A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","summary":"A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","description":"Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n":{"value":{"name":"Request for Tableau","description":"A request type that allows a user to request access to Tableau","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"USER","description":"Approval from Data Analytics Team Head - Stan Lee","approverUserId":"00ub0oNGTSWTBKOLGLNR"}]}},"key":"A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","summary":"A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","description":"Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n"},"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n":{"value":{"name":"Request for Group","description":"A request type that requires approval from the owner of the group","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"RESOURCE_OWNER"}]}},"key":"A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n","summary":"A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n","description":"Create a request type that requires approval from the owner of the resource\n","id":"paths/~1governance~1api~1v1~1request-types/post/requestBody/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.":{"value":{"id":"08ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","summary":"When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","description":"The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.":{"value":{"id":"10ab2db568c7c300079fefd0","name":"salesforce-01-request-type-07","description":"How anyone can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=10ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2210ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/10ab2db568c7c300079fefd0"}}},"key":"For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","summary":"For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","description":"Creating a request type and anyone may request it and not using default.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group":{"value":{"id":"07ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-01","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=07ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2207ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/07ab2db568c7c300079fefd0"}}},"key":"For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","summary":"For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","description":"Creating a request type to enable requests for access to a group","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application":{"value":{"id":"01ab2db568c7c300079fefd0","name":"salesforce-01-request-type-01","description":"How users can get manager's approval to access Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=01ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2201ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/01ab2db568c7c300079fefd0"}}},"key":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","summary":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","description":"Creating a request type to enable requests for access to an application","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.":{"value":{"id":"04ab2db568c7c300079fefd0","name":"salesforce-01-request-type-04","description":"How users can request access to Salesforce 01, approving manager must select justification","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the justification for granting access?","required":true,"type":"SELECT","options":[{"value":"Required to perform job duties"},{"value":"Required to perform one time task"}]}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=04ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2204ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/04ab2db568c7c300079fefd0"}}},"key":"Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","summary":"Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field":{"value":{"id":"03ab2db568c7c300079fefd0","name":"salesforce-01-request-type-03","description":"How users can request access to Salesforce 01 and provide text input","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for your employee's access?","required":true,"type":"TEXT"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=03ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2203ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/03ab2db568c7c300079fefd0"}}},"key":"Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","summary":"Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","description":"Full representation of approver text field","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.":{"value":{"id":"05ab2db568c7c300079fefd0","name":"salesforce-01-request-type-05","description":"How users can request access to Salesforce 01, approving manager must approve and answer a question using a DATE-TIME field","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What time should access be revoked?","required":true,"type":"DATE-TIME"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=05ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2205ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/05ab2db568c7c300079fefd0"}}},"key":"Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","summary":"Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","description":"Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.":{"value":{"id":"06ab2db568c7c300079fefd0","name":"admin-group-01-request-type-01","description":"How users can request access to Admin Group 01, with multiple approvals, where each approval demonstrates a different way to specify the approver.","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Admin Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]},{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00garwpuyxHaWOkdV0g4"],"approverFields":[]},{"approverType":"USER","description":"Approval from the specified user","approverUserId":"00ub0oNGTSWTBKOLGLNR","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=06ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2206ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/06ab2db568c7c300079fefd0"}}},"key":"Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","summary":"Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","description":"Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.":{"value":{"id":"09ab2db568c7c300079fefd0","name":"salesforce-01-request-type-06","description":"How users can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","type":"TEXT","prompt":"Why are you requesting access?","required":false}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"TEXT","prompt":"Why are you approving access?","required":true}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=09ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2209ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/09ab2db568c7c300079fefd0"}}},"key":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","summary":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","description":"When a requester field is optional. **Note** approverFields always required if present.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.":{"value":{"id":"12ab2db568c7c300079fefd0","name":"salesforce-01-request-type-09","description":"How group members can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"MEMBER_OF","requesterMemberOf":["00garwpuyxHaWOkdV0g4"],"requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for access?","type":"TEXT","required":true}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=12ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2212ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/12ab2db568c7c300079fefd0"}}},"key":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","summary":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","description":"Creating a request type where only members of a group may request access to the application.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.":{"value":{"id":"08ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":"P40D","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","summary":"An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time.","description":"A request type created with active status where all requests will only grant access for a limited duration of time.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/An active request type with time bound access |tooltip| A request type created with active status where all requests will only grant access for a limited duration of time."},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n":{"value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Grammarly","description":"A request type that allows a user to request access to Grammarly","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Grammarly"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"NONE"},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Grammarly&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","summary":"A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","description":"Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type that requires no approval |tooltip| Create a request type that allows anyone to request access to Grammarly.  No questions are required, and no approvals are required.\n"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n":{"value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Tableau","description":"A request type that allows a user to request access to Tableau","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Tableau"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"USER","description":"Approval from Data Analytics Team Head - Stan Lee","approverUserId":"00ub0oNGTSWTBKOLGLNR","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Tableau&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","summary":"A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","description":"Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring an approval that has a description |tooltip| Create a request type that allows anyone to request access to Tableau.  No questions are required, and no approvals are required.\n"},"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n":{"value":{"id":"08ab2db568c7c300079fefd0","name":"Request for Group","description":"A request type that requires approval from the owner of the group","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"RESOURCE_OWNER","description":"Approval from the resource owner","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20for%20Group&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n","summary":"A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n","description":"Create a request type that requires approval from the owner of the resource\n","id":"paths/~1governance~1api~1v1~1request-types/post/responses/201/content/application~1json/examples/A request type requiring resource owner approval |tooltip| Create a request type that requires approval from the owner of the resource\n"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization.":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterMemberOf/0 00g1emaKYZTWRYYRRTWX not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"00g1emaKYZTWRYYRRTWX not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"body","location":"/requestSettings/requesterMemberOf/0","domain":"governance"}]},"key":"When requesterMemberOf contains an not found Okta Group id |tooltip| When /requestSettings/requesterMemberOf/0 contains a groupId that is not discoverable in your Okta organization.","summary":"When requesterMemberOf contains an not found Okta Group id |tooltip| When /requestSettings/requesterMemberOf/0 contains a groupId that is not discoverable in your Okta organization.","description":"When /requestSettings/requesterMemberOf/0 contains a groupId that is not discoverable in your Okta organization.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requesterMemberOf contains an not found Okta Group id |tooltip| When ~1requestSettings~1requesterMemberOf~10 contains a groupId that is not discoverable in your Okta organization."},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals/0/approverMemberOf/0 must NOT have more than 1 items","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have more than 1 items","reason":"INVALID_ARRAY_LENGTH_OVER_MAX","locationType":"body","location":"/approvalSettings/approvals/0/approverMemberOf/0","domain":"governance"}]},"key":"When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in /approvalSettings/approvals/0/approverMemberOf/0","summary":"When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in /approvalSettings/approvals/0/approverMemberOf/0","description":"When too many Okta groupIds are included in /approvalSettings/approvals/0/approverMemberOf/0","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When too many Okta groupIds are included in approverMemberOf |tooltip| When too many Okta groupIds are included in ~1approvalSettings~1approvals~10~1approverMemberOf~10"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterMemberOf must have required property 'requesterMemberOf'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'requesterMemberOf'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/requestSettings/requesterMemberOf","domain":"governance"}]},"key":"When required /requestSettings/requesterMemberOf is missing |tooltip| When required /requestSettings/requesterMemberOf is missing","summary":"When required /requestSettings/requesterMemberOf is missing |tooltip| When required /requestSettings/requesterMemberOf is missing","description":"When required /requestSettings/requesterMemberOf is missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When required ~1requestSettings~1requesterMemberOf is missing |tooltip| When required ~1requestSettings~1requesterMemberOf is missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/options/0/value must NOT have more than 280 characters","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have more than 280 characters","reason":"INVALID_STRING_LENGTH_OVER_MAX","locationType":"body","location":"/requestSettings/requesterFields/0/options/0/value","domain":"governance"}]},"key":"When SELECT option value exceeds max length |tooltip| When /requestSettings/requesterFields/0/options/0/value exceeds max length","summary":"When SELECT option value exceeds max length |tooltip| When /requestSettings/requesterFields/0/options/0/value exceeds max length","description":"When /requestSettings/requesterFields/0/options/0/value exceeds max length","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT option value exceeds max length |tooltip| When ~1requestSettings~1requesterFields~10~1options~10~1value exceeds max length"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/options must have required property 'options'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'options'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/requestSettings/requesterFields/0/options","domain":"governance"}]},"key":"When SELECT options are missing |tooltip| When /requestSettings/requesterFields/0/options is missing","summary":"When SELECT options are missing |tooltip| When /requestSettings/requesterFields/0/options is missing","description":"When /requestSettings/requesterFields/0/options is missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When SELECT options are missing |tooltip| When ~1requestSettings~1requesterFields~10~1options is missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals/0/approverFields/0/ must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","reason":"INVALID_ENUM_VALUE","locationType":"body","location":"/approvalSettings/approvals/0/approverFields/0/type","domain":"governance"}]},"key":"When approver field type is invalid |tooltip| When approver field type is invalid","summary":"When approver field type is invalid |tooltip| When approver field type is invalid","description":"When approver field type is invalid","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approver field type is invalid |tooltip| When approver field type is invalid"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestSettings/requesterFields/0/type must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must be equal to one of the allowed values: SELECT, TEXT, DATE-TIME","reason":"INVALID_ENUM_VALUE","locationType":"body","location":"/requestSettings/requesterFields/0/type","domain":"governance"}]},"key":"When requester field type is invalid |tooltip| When requester field type is invalid","summary":"When requester field type is invalid |tooltip| When requester field type is invalid","description":"When requester field type is invalid","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requester field type is invalid |tooltip| When requester field type is invalid"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /approvalSettings/approvals must NOT have fewer than 1 items","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must NOT have fewer than 1 items","reason":"INVALID_ARRAY_LENGTH_UNDER_MIN","locationType":"body","location":"/approvalSettings/approvals","domain":"governance"}]},"key":"NoApprovals","summary":"NoApprovals","description":"When approvals is empty array","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/NoApprovals"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: ownerId must be a Team in your organization.","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"ownerId must be a Team in your organization.","reason":"IDENTIFIER_NOT_FOUND","locationType":"body","location":"ownerId","domain":"governance"}]},"key":"TeamIdInvalid","summary":"TeamIdInvalid","description":"When ownerId is invalid","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/TeamIdInvalid"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'ownerId'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'ownerId'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/ownerId","domain":"governance"}]},"key":"When ownerId is missing |tooltip| When /ownerId is missing","summary":"When ownerId is missing |tooltip| When /ownerId is missing","description":"When /ownerId is missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId is missing |tooltip| When ~1ownerId is missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'requestSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'requestSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/","domain":"governance"}]},"key":"When requestSettings is missing |tooltip| When /requestSettings is missing","summary":"When requestSettings is missing |tooltip| When /requestSettings is missing","description":"When /requestSettings is missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When requestSettings is missing |tooltip| When ~1requestSettings is missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'ownerId', must have required property 'resourceSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'ownerId'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/ownerId","domain":"governance"},{"errorSummary":"must have required property 'resourceSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/resourceSettings","domain":"governance"}]},"key":"When ownerId and resourceSettings are missing |tooltip| When /ownerId /resourceSettings are missing","summary":"When ownerId and resourceSettings are missing |tooltip| When /ownerId /resourceSettings are missing","description":"When /ownerId /resourceSettings are missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When ownerId and resourceSettings are missing |tooltip| When ~1ownerId ~1resourceSettings are missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: must have required property 'approvalSettings'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"must have required property 'approvalSettings'","reason":"REQUIRED_PROPERTY_MISSING","locationType":"body","location":"/","domain":"governance"}]},"key":"When approvalSettings is missing |tooltip| When /approvalSettings is missing","summary":"When approvalSettings is missing |tooltip| When /approvalSettings is missing","description":"When /approvalSettings is missing","id":"paths/~1governance~1api~1v1~1request-types/post/responses/400/content/application~1json/examples/When approvalSettings is missing |tooltip| When ~1approvalSettings is missing"},"paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/post/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/post/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/post/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter":{"value":{"data":[{"id":"08ab2db568c7c300079fefd","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},{"id":"10ab2db568c7c300079fefd","name":"salesforce-01-request-type-07","description":"How anyone can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=10ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2210ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/10ab2db568c7c300079fefd0"}}},{"id":"07ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-01","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=07ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2207ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/07ab2db568c7c300079fefd0"}}},{"id":"01ab2db568c7c300079fefd0","name":"salesforce-01-request-type-01","description":"How users can get manager's approval to access Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=01ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2201ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/01ab2db568c7c300079fefd0"}}},{"id":"04ab2db568c7c300079fefd0","name":"salesforce-01-request-type-04","description":"How users can request access to Salesforce 01, approving manager must select justification","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=04ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2204ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/04ab2db568c7c300079fefd0"}}},{"id":"03ab2db568c7c300079fefd0","name":"salesforce-01-request-type-03","description":"How users can request access to Salesforce 01 and provide text input","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=03ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2203ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/03ab2db568c7c300079fefd0"}}},{"id":"05ab2db568c7c300079fefd0","name":"salesforce-01-request-type-05","description":"How users can request access to Salesforce 01, approving manager must approve and answer a question using a DATE-TIME field","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=05ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2205ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/05ab2db568c7c300079fefd0"}}},{"id":"06ab2db568c7c300079fefd0","name":"admin-group-01-request-type-01","description":"How users can request access to Admin Group 01, with multiple approvals, where each approval demonstrates a different way to specify the approver.","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=06ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2206ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/06ab2db568c7c300079fefd0"}}},{"id":"09ab2db568c7c300079fefd0","name":"salesforce-01-request-type-06","description":"How users can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=09ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2209ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/09ab2db568c7c300079fefd0"}}},{"id":"12ab2db568c7c300079fefd0","name":"salesforce-01-request-type-09","description":"How group members can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=12ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2212ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/12ab2db568c7c300079fefd0"}}}],"_links":{"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types?limit=20"}}},"key":"List request types response with no filter |tooltip| A list of request type with no filter","summary":"List request types response with no filter |tooltip| A list of request type with no filter","description":"A list of request type with no filter","id":"paths/~1governance~1api~1v1~1request-types/get/responses/200/content/application~1json/examples/List request types response with no filter |tooltip| A list of request type with no filter"},"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Empty value found for query parameter 'after'","reason":"EMPTY_PARAMETER","locationType":"query","location":"/after","domain":"governance"}]},"key":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","summary":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","description":"A request contains the `after` query parameter but it's empty (?after=)","id":"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)"},"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a request type id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"key":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","summary":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","description":"When after query parameter value is invalid format (?after=1)","id":"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)"},"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"key":"When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","summary":"When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist","description":"When a request contains after query parameter with request type ID that does not exist","id":"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request type ID that does not exist"},"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Invalid `orderBy` syntax","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/orderBy","domain":"governance"}]},"key":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","summary":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","description":"Invalid `orderBy` parameter error response","id":"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response"},"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"The `limit` parameter isn't valid.","reason":"INVALID_DATA_TYPE","locationType":"query","location":"/limit","domain":"governance"}]},"key":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","summary":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","description":"Invalid `limit` parameter error response","id":"paths/~1governance~1api~1v1~1request-types/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"},"paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/get/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/get/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/get/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types/get/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status":{"value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=0oa1gjh63g214q0Hq0g4","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"key":"When getting a request type in published status |tooltip| When getting a request type in published status","summary":"When getting a request type in published status |tooltip| When getting a request type in published status","description":"When getting a request type in published status","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status":{"value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2019-08-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"key":"When getting a request type in draft status |tooltip| When getting a request type in draft status","summary":"When getting a request type in draft status |tooltip| When getting a request type in draft status","description":"When getting a request type in draft status","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type":{"value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"Request type created through WEB","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2019-08-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","resourceSettings":{"type":"CUSTOM"},"requestSettings":{"type":"CUSTOM"},"approvalSettings":{"type":"CUSTOM"},"ownerId":"61eb0f06c462d20007f051ac","status":"ACTIVE","lastUpdateSource":"WEB","accessDuration":null,"_links":{"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"}}},"key":"When getting a custom request type |tooltip| When getting a custom request type","summary":"When getting a custom request type |tooltip| When getting a custom request type","description":"When getting a custom request type","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When getting a custom request type |tooltip| When getting a custom request type"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.":{"value":{"id":"08ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-02","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=08ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2208ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0"}}},"key":"When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","summary":"When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","description":"The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/When request type is for groups, has minimal required properties |tooltip| The minimal set of properties to pass when creating a Request Type. Allows anyone to request access to the Admin Group. No questions are required, and there is only one approval required by the requesting user's manager."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.":{"value":{"id":"10ab2db568c7c300079fefd0","name":"salesforce-01-request-type-07","description":"How anyone can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=10ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2210ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/10ab2db568c7c300079fefd0"}}},"key":"For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","summary":"For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default.","description":"Creating a request type and anyone may request it and not using default.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, includes defaults |tooltip| Creating a request type and anyone may request it and not using default."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group":{"value":{"id":"07ab2db568c7c300079fefd0","name":"low-privilege-group-01-request-type-01","description":"How users can request access to low privilege Group 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Low privilege Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=07ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2207ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/07ab2db568c7c300079fefd0"}}},"key":"For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","summary":"For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group","description":"Creating a request type to enable requests for access to a group","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to group, manager's approval required |tooltip| Creating a request type to enable requests for access to a group"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application":{"value":{"id":"01ab2db568c7c300079fefd0","name":"salesforce-01-request-type-01","description":"How users can get manager's approval to access Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=01ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2201ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/01ab2db568c7c300079fefd0"}}},"key":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","summary":"For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application","description":"Creating a request type to enable requests for access to an application","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/For access to app, manager's approval required |tooltip| Creating a request type to enable requests for access to an application"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.":{"value":{"id":"04ab2db568c7c300079fefd0","name":"salesforce-01-request-type-04","description":"How users can request access to Salesforce 01, approving manager must select justification","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the justification for granting access?","required":true,"type":"SELECT","options":[{"value":"Required to perform job duties"},{"value":"Required to perform one time task"}]}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=04ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2204ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/04ab2db568c7c300079fefd0"}}},"key":"Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","summary":"Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","description":"Creating a request type where anyone may request access. The requester's manager needs to approve and select an option.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required select field |tooltip| Creating a request type where anyone may request access. The requester's manager needs to approve and select an option."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field":{"value":{"id":"03ab2db568c7c300079fefd0","name":"salesforce-01-request-type-03","description":"How users can request access to Salesforce 01 and provide text input","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for your employee's access?","required":true,"type":"TEXT"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=03ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2203ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/03ab2db568c7c300079fefd0"}}},"key":"Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","summary":"Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field","description":"Full representation of approver text field","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver field specifies text defaults explicitly |tooltip| Full representation of approver text field"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.":{"value":{"id":"05ab2db568c7c300079fefd0","name":"salesforce-01-request-type-05","description":"How users can request access to Salesforce 01, approving manager must approve and answer a question using a DATE-TIME field","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What time should access be revoked?","required":true,"type":"DATE-TIME"}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=05ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2205ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/05ab2db568c7c300079fefd0"}}},"key":"Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","summary":"Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","description":"Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Manager approver has required date-time field |tooltip| Payload for creating request type where the requester's manager needs to approve and answer a question using a DATE-TIME field."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.":{"value":{"id":"06ab2db568c7c300079fefd0","name":"admin-group-01-request-type-01","description":"How users can request access to Admin Group 01, with multiple approvals, where each approval demonstrates a different way to specify the approver.","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK","resourceName":"Admin Group 01"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]},{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00garwpuyxHaWOkdV0g4"],"approverFields":[]},{"approverType":"USER","description":"Approval from the specified user","approverUserId":"00ub0oNGTSWTBKOLGLNR","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=06ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2206ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/06ab2db568c7c300079fefd0"}}},"key":"Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","summary":"Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","description":"Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Multi-step approvals, one of each type |tooltip| Payload for creating request type where there are many approval steps, where each step demonstrates a different way to specify who may approve."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.":{"value":{"id":"09ab2db568c7c300079fefd0","name":"salesforce-01-request-type-06","description":"How users can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","type":"TEXT","prompt":"Why are you requesting access?","required":false}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"TEXT","prompt":"Why are you approving access?","required":true}]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=09ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2209ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/09ab2db568c7c300079fefd0"}}},"key":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","summary":"Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present.","description":"When a requester field is optional. **Note** approverFields always required if present.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Optional requester field |tooltip| When a requester field is optional. **Note** approverFields always required if present."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.":{"value":{"id":"12ab2db568c7c300079fefd0","name":"salesforce-01-request-type-09","description":"How group members can request access to Salesforce 01","created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","lastUpdateSource":"API","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"APPS","targetResources":[{"resourceId":"0oafxqCAJWWGELFTYASJ"}]},"requestSettings":{"type":"MEMBER_OF","requesterMemberOf":["00garwpuyxHaWOkdV0g4"],"requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for access?","type":"TEXT","required":true}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MANAGER","description":"Approval from the requester's manager","approverFields":[]}]},"accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=12ab2db568c7c300079fefd0","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2212ab2db568c7c300079fefd0%22"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/12ab2db568c7c300079fefd0"}}},"key":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","summary":"Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application.","description":"Creating a request type where only members of a group may request access to the application.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/200/content/application~1json/examples/Requester must be member of a group |tooltip| Creating a request type where only members of a group may request access to the application."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/get/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}/delete/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status":{"value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"ACTIVE","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"createRequest":{"href":"https://my-org.at.okta.com/next/new?q=Request%20access%20to%20Salesforce&request_type=0oa1gjh63g214q0Hq0g4","type":"text/html"},"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"key":"When getting a request type in published status |tooltip| When getting a request type in published status","summary":"When getting a request type in published status |tooltip| When getting a request type in published status","description":"When getting a request type in published status","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/200/content/application~1json/examples/When getting a request type in published status |tooltip| When getting a request type in published status"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Cannot publish or unpublish a DISABLED request type. Repair the request type using the administrative user interface.","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type","summary":"When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type","description":"When attempting to publish a DISABLED request type","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1publish/post/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status":{"value":{"id":"61eb2db568c7c300079fefd0","name":"salesforce-01","description":"How users can request access to Salesforce 01","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2019-08-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","status":"DRAFT","ownerId":"61eb0f06c462d20007f051ac","resourceSettings":{"type":"GROUPS","targetResources":[{"resourceId":"00g1emaKYZTWRYYRRTSK"}]},"requestSettings":{"type":"EVERYONE","requesterFields":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification?","required":true,"type":"TEXT"}]},"approvalSettings":{"type":"SERIAL","approvals":[{"approverType":"MEMBER_OF","description":"Approval from a member of the specified OKTA group","approverMemberOf":["00g1emaKYZTWRYYRRTSK"],"approverFields":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","prompt":"What is the business justification?","required":true,"type":"TEXT"}]}]},"lastUpdateSource":"API","accessDuration":null,"_links":{"requests":{"href":"https://myorg.okta.com/governance/api/v1/requests?filter=requestTypeId%20eq%20%2261eb2db568c7c300079fefd0%22","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0"}}},"key":"When getting a request type in draft status |tooltip| When getting a request type in draft status","summary":"When getting a request type in draft status |tooltip| When getting a request type in draft status","description":"When getting a request type in draft status","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/200/content/application~1json/examples/When getting a request type in draft status |tooltip| When getting a request type in draft status"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Cannot publish or unpublish a DISABLED request type. Repair the request type using the administrative user interface.","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type","summary":"When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type","description":"When attempting to publish a DISABLED request type","id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/409/content/application~1json/examples/When attempting to publish a DISABLED request type |tooltip| When attempting to publish a DISABLED request type"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1request-types~1{requestTypeId}~1un-publish/post/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams":{"value":{"data":[{"id":"08ab2db568c7c300079fefd0","name":"Salesforce admins","created":"2022-05-24T14:15:22Z","lastUpdated":"2022-05-24T14:15:22Z"},{"id":"08ab2db568c7c300079fefd0","name":"Netsuite admins","created":"2022-05-24T14:15:22Z","lastUpdated":"2022-05-24T14:15:22Z"}]},"key":"List teams |tooltip| A list of teams","summary":"List teams |tooltip| A list of teams","description":"A list of teams","id":"paths/~1governance~1api~1v1~1teams/get/responses/200/content/application~1json/examples/List teams |tooltip| A list of teams"},"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Empty value found for query parameter 'after'","reason":"EMPTY_PARAMETER","locationType":"query","location":"/after","domain":"governance"}]},"key":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","summary":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","description":"A request contains the `after` query parameter but it's empty (?after=)","id":"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)"},"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a team id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"key":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","summary":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","description":"When after query parameter value is invalid format (?after=1)","id":"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)"},"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"key":"When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","summary":"When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist","description":"When a request contains after query parameter with team ID that does not exist","id":"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with team ID that does not exist"},"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Invalid `orderBy` syntax","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/orderBy","domain":"governance"}]},"key":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","summary":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","description":"Invalid `orderBy` parameter error response","id":"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response"},"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"The `limit` parameter isn't valid.","reason":"INVALID_DATA_TYPE","locationType":"query","location":"/limit","domain":"governance"}]},"key":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","summary":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","description":"Invalid `limit` parameter error response","id":"paths/~1governance~1api~1v1~1teams/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"},"paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1teams/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1teams/get/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1teams/get/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter":{"value":{"data":[{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"created":"2022-05-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-24T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-24T14:15:22Z","requestStatus":"RESOLVED","type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":2,"resolved":null,"requestStatus":"OPEN","type":"CUSTOM","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}}],"_links":{"self":{"href":"https://myorg.okta.com/governance/api/v1/requests?limit=1"},"next":{"href":"https://myorg.okta.com/governance/api/v1/requests?limit=1&after=SDERDSDx00ub0oNGTSWTBKOLGLNR"}}},"key":"List Request response with no filter |tooltip| A List Request response with no filter","summary":"List Request response with no filter |tooltip| A List Request response with no filter","description":"A List Request response with no filter","id":"paths/~1governance~1api~1v1~1requests/get/responses/200/content/application~1json/examples/List Request response with no filter |tooltip| A List Request response with no filter"},"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Empty value found for query parameter 'after'","reason":"EMPTY_PARAMETER","locationType":"query","location":"/after","domain":"governance"}]},"key":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","summary":"Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)","description":"A request contains the `after` query parameter but it's empty (?after=)","id":"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Empty `after` parameter error response |tooltip| A request contains the `after` query parameter but it's empty (?after=)"},"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must NOT have fewer than 24 characters","reason":"INVALID_STRING_LENGTH_UNDER_MIN","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must match pattern \"^[a-fA-F\\\\d]{24}$\"","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"},{"domain":"governance","errorSummary":"must be a request id","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/after"}]},"key":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","summary":"When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)","description":"When after query parameter value is invalid format (?after=1)","id":"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter is invalid format |tooltip| When after query parameter value is invalid format (?after=1)"},"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request.","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"08ab2db568c7c300079fefd0 not found","reason":"IDENTIFIER_NOT_FOUND","locationType":"query","location":"/after","domain":"governance"}]},"key":"When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","summary":"When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist","description":"When a request contains after query parameter with request ID that does not exist","id":"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/When after parameter value not found |tooltip| When a request contains after query parameter with request ID that does not exist"},"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"Invalid `orderBy` syntax","reason":"STRING_FORMAT_INVALID","locationType":"query","location":"/orderBy","domain":"governance"}]},"key":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","summary":"Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response","description":"Invalid `orderBy` parameter error response","id":"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `orderBy` parameter error response |tooltip| Invalid `orderBy` parameter error response"},"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response":{"value":{"errorCode":"E0000029","errorSummary":"Invalid paging request","errorLink":"E0000029","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"errorSummary":"The `limit` parameter isn't valid.","reason":"INVALID_DATA_TYPE","locationType":"query","location":"/limit","domain":"governance"}]},"key":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","summary":"Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response","description":"Invalid `limit` parameter error response","id":"paths/~1governance~1api~1v1~1requests/get/responses/400/content/application~1json/examples/Invalid `limit` parameter error response |tooltip| Invalid `limit` parameter error response"},"paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1requests/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests/get/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests/get/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests/get/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`":{"value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce"},"key":"When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","summary":"When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","description":"Request access for authenticated user by omitting `requesterUserIds`","id":"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`"},"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`":{"value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce","requesterUserIds":["00uijntSwJjSHtDY70g3"]},"key":"When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","summary":"When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","description":"As an admin service account, request access for a user by providing `requesterUserIds`","id":"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`"},"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values":{"value":{"requestTypeId":"08ab2db568c7c300079fefd0","subject":"I need access to Salesforce","requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","value":"To fulfill my job duties"},{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","value":"2022-05-05T14:15:22Z"},{"id":"1c5ef673-8dbb-4b9c-ac76-0b4180116e43","value":["Salesforce"]}]},"key":"When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values","summary":"When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values","description":"As an admin service account, request access for a user and provide required field values","id":"paths/~1governance~1api~1v1~1requests/post/requestBody/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user and provide required field values"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","summary":"When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`","description":"Request access for authenticated user by omitting `requesterUserIds`","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for authenticated user |tooltip| Request access for authenticated user by omitting `requesterUserIds`"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00uijntSwJjSHtDY70g3"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","summary":"When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","description":"As an admin service account, request access for a user by providing `requesterUserIds`","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When requesting for non-authenticated user |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","required":true,"value":null}],"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When request's request type has required requester fields |tooltip| When request's request type has required requester fields","summary":"When request's request type has required requester fields |tooltip| When request's request type has required requester fields","description":"When request's request type has required requester fields","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has required requester fields |tooltip| When request's request type has required requester fields"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"08ab2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00uijntSwJjSHtDY70g3"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","required":true,"type":"TEXT","prompt":"What is the business jutification?","value":"To fulfill my job duties"},{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","required":true,"type":"DATE-TIME","prompt":"When do you need access until?","value":"2022-05-05T14:15:22Z"},{"id":"1c5ef673-8dbb-4b9c-ac76-0b4180116e43","required":true,"type":"SELECT","prompt":"What do you need access to?","value":["Salesforce"]}],"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/08ab2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","summary":"When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`","description":"As an admin service account, request access for a user by providing `requesterUserIds`","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request type has required fields |tooltip| As an admin service account, request access for a user by providing `requesterUserIds`"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","summary":"When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required","description":"When request's request type has no requester fields, one approval required","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, one approval required |tooltip| When request's request type has no requester fields, one approval required"},"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"Tom requests access to Salesforce","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":null,"requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":null,"approvals":[{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ae2"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required","summary":"When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required","description":"When request's request type has no requester fields, many approvals required","id":"paths/~1governance~1api~1v1~1requests/post/responses/201/content/application~1json/examples/When request's request type has no requester fields, many approvals required |tooltip| When request's request type has no requester fields, many approvals required"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterUserIds/0 00u22uiKQa0xXkbdGLNR not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"00u22uiKQa0xXkbdGLNR not found","location":"/requesterUserIds/0","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"key":"When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","summary":"When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found.","description":"Bad request response when a requesterUserId cannot be found.","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When a requester user id cannot be found |tooltip| Bad request response when a requesterUserId cannot be found."},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requestTypeId 61eb2db568c7c300079fefd0 not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"61eb2db568c7c300079fefd0 not found","location":"/requestTypeId","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"key":"When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","summary":"When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found.","description":"Bad request response when requestTypeId cannot be found.","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When the request type cannot be found |tooltip| Bad request response when requestTypeId cannot be found."},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'id'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'id'","location":"/requesterFieldValues/0/id","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"key":"When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","summary":"When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided","description":"When the requesterFieldValues contains an item but no id is provided","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no id is provided"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/id must be uuid v4","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be uuid v4","location":"/requesterFieldValues/0/id","locationType":"body","reason":"STRING_FORMAT_INVALID"}]},"key":"When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","summary":"When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid","description":"When the requesterFieldValues contains an item and the id is invalid","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field id in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the id is invalid"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/id 05c87fe9-11f6-4d40-a033-b155b39dcdbe not found","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"05c87fe9-11f6-4d40-a033-b155b39dcdbe not found","location":"/requesterFieldValues/0/id","locationType":"body","reason":"IDENTIFIER_NOT_FOUND"}]},"key":"When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","summary":"When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found","description":"When the `requesterFieldValues` contains an item with an `id` that can't be found","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field ID not found |tooltip| When the `requesterFieldValues` contains an item with an `id` that can't be found"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'value'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'value'","location":"/requesterFieldValues/0/value","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"key":"When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","summary":"When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided","description":"When the requesterFieldValues contains an item but no value is provided","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no value is provided"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/value must be date-time","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be date-time","location":"/requesterFieldValues/0/value","locationType":"body","reason":"STRING_FORMAT_INVALID"}]},"key":"When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","summary":"When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid","description":"When the requesterFieldValues contains an item and the value is invalid","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field value in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the value is invalid"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0 must have required property 'type'","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have required property 'type'","location":"/requesterFieldValues/0/value","locationType":"body","reason":"REQUIRED_PROPERTY_MISSING"}]},"key":"When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","summary":"When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided","description":"When the requesterFieldValues contains an item but no type is provided","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type is not provided in fieldValues |tooltip| When the requesterFieldValues contains an item but no type is provided"},"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues/0/type must be equal to one of the allowed values: TEXT, SELECT, DATE-TIME","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must be equal to one of the allowed values: TEXT, SELECT, DATE-TIME","location":"/requesterFieldValues/0/type","locationType":"body","reason":"INVALID_ENUM_VALUE"}]},"key":"When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid","summary":"When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid","description":"When the requesterFieldValues contains an item and the type is invalid","id":"paths/~1governance~1api~1v1~1requests/post/responses/400/content/application~1json/examples/When field type in requesterFieldValues is invalid |tooltip| When the requesterFieldValues contains an item and the type is invalid"},"paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1requests/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action.","errorLink":"E0000006","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","reason":"INSUFFICIENT_PERMISSIONS","errorSummary":"Authenticated user must be a Super Admin or Access Request Admin."}]},"key":"Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","summary":"Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role.","description":"Operation restricted to authenticated users with Super Admin or Access Request Admin role.","id":"paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user is not an admin |tooltip| Operation restricted to authenticated users with Super Admin or Access Request Admin role."},"paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user.":{"value":{"errorCode":"E0000006","errorSummary":"You do not have permission to perform the requested action.","errorLink":"E0000006","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Authenticated user and contents of /body/requesterUserIds must be members of the group specified in the request type's /requestSettings/requesterMemberOf array.","location":"/requesterUserIds","locationType":"body","reason":"REQUEST_TYPE_SETTINGS"}]},"key":"Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in /requestSettings/requesterMemberOf, that restriction also applies to the authenticated user.","summary":"Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in /requestSettings/requesterMemberOf, that restriction also applies to the authenticated user.","description":"When the request's request type specifies that the requester must be a member of a group in /requestSettings/requesterMemberOf, that restriction also applies to the authenticated user.","id":"paths/~1governance~1api~1v1~1requests/post/responses/403/content/application~1json/examples/Authenticated user not member of group in request settings |tooltip| When the request's request type specifies that the requester must be a member of a group in ~1requestSettings~1requesterMemberOf, that restriction also applies to the authenticated user."},"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DISABLED","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DISABLED","location":"/requestTypeId","locationType":"body","reason":"REQUEST_TYPE_STATE"}]},"key":"When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","summary":"When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status.","description":"Conflict response when creating a request using a request type in disabled status.","id":"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in disabled status |tooltip| Conflict response when creating a request using a request type in disabled status."},"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.":{"value":{"errorCode":"E0000195","errorSummary":"Api validation failed due to conflict: Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DRAFT","errorLink":"E0000195","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"Request type 61eb2db568c7c300079fefd0 must be ACTIVE. Current status: DRAFT","location":"/requestTypeId","locationType":"body","reason":"REQUEST_TYPE_STATE"}]},"key":"When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","summary":"When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status.","description":"Conflict response when creating a request using a request type in draft status.","id":"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When the request type in draft status |tooltip| Conflict response when creating a request using a request type in draft status."},"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue":{"value":{"errorCode":"E0000001","errorSummary":"Api validation failed: /requesterFieldValues must have all required requesterFields","errorLink":"E0000001","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[{"domain":"governance","errorSummary":"must have all required requesterFields","location":"/requesterFieldValues","locationType":"body","reason":"REQUEST_TYPE_SETTINGS"}]},"key":"When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue","summary":"When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue","description":"When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue","id":"paths/~1governance~1api~1v1~1requests/post/responses/409/content/application~1json/examples/When request is missing required requester field |tooltip| When the request type has a required requesterField, but the add request operation does not provide a matching requesterFieldValue"},"paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests/post/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","action":"ASSIGN_APP_TO_USER","actionId":"62f6d63a1764a30007763ad5","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"Resolved request with one approval |tooltip| Success response to get a Request","summary":"Resolved request with one approval |tooltip| Success response to get a Request","description":"Success response to get a Request","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Resolved request with one approval |tooltip| Success response to get a Request"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2019-08-24T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z'","requestStatus":"OPEN","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]},{"status":"PENDING","approvalId":"62f6d63a1764a30007763ad5"}],"actions":[{"status":"PENDING","action":"ASSIGN_APP_TO_USER","actionId":"62f57938cd367b0008eb47c7"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","summary":"Open request with requester and approver field values |tooltip| Two required approvals, but one still pending","description":"Two required approvals, but one still pending","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Open request with requester and approver field values |tooltip| Two required approvals, but one still pending"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"type":"CUSTOM","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","summary":"Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type","description":"Success response for GET Request using CUSTOM Request Type","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Request using CUSTOM Request Type |tooltip| Success response for GET Request using CUSTOM Request Type"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","actionId":"62f6d63a1764a30007763ad5","action":"ASSIGN_APP_TO_USER","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","accessRemoved":"2022-06-12T21:36:25.344Z","resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","summary":"Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired.","description":"A request where access has been granted, and the accessDuration has expired.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, ten day access duration |tooltip| A request where access has been granted, and the accessDuration has expired."},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future.":{"value":{"id":"61eb06a3c462d20007f0235c","subject":"request-from-service-now-xsd23432","requestTypeId":"61eb2db568c7c300079fefd0","created":"2022-05-05T14:15:22Z","createdBy":"00ub0oNGTSWTBKOLGLNR","lastUpdated":"2022-05-05T14:15:22Z","lastUpdatedBy":"00ub0oNGTSWTBKOLGLNR","permalinkId":1,"resolved":"2022-05-05T14:15:22Z","requestStatus":"RESOLVED","requesterUserIds":["00ub0oNGTSWTBKOLGLNR"],"requesterFieldValues":[{"id":"05c87fe9-11f6-4d40-a033-b155b39dcdbe","prompt":"What is the business justification for the request?","type":"TEXT","value":"I need access to complete a task.","required":true}],"approvals":[{"status":"COMPLETED","approvalId":"62f6d63a1764a30007763ae2","approverId":"00ub0oNGTSWTBKOLGLNR","approverName":"Becky Raferty","decision":"APPROVED","decided":"2022-06-02T21:36:25.344Z","fieldValues":[{"id":"ec9da40d-9c1b-41c6-8016-edfd010b02d2","type":"SELECT","prompt":"What is the business justification for the request?","required":true,"value":["Curious"]}]}],"actions":[{"status":"COMPLETED","action":"ASSIGN_APP_TO_USER","actionId":"62f6d63a1764a30007763ad5","actionStatus":"SUCCEEDED","actionAttempted":"2022-06-02T21:36:25.344Z","accessRemoved":null,"resourceId":"0oafxqCAJWWGELFTYASJ","resourceName":"Salesforce 01","resourceType":"APP"}],"type":"ACCESS_REQUEST","_links":{"requestType":{"href":"https://myorg.okta.com/governance/api/v1/request-types/61eb2db568c7c300079fefd0","type":"application/json"},"self":{"href":"https://myorg.okta.com/governance/api/v1/requests/61eb06a3c462d20007f0235c","type":"application/json"}}},"key":"Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future.","summary":"Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future.","description":"A request where access has been granted, but it is time bounded and will be revoked in the future.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/200/content/application~1json/examples/Time bound access, not yet expired |tooltip| A request where access has been granted, but it is time bounded and will be revoked in the future."},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example":{"value":{"errorCode":"E0000004","errorSummary":"You don't have permission to perform the requested action.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/403/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example":{"value":{"errorCode":"E0000007","errorSummary":"Resource not found exception","errorLink":"E0000007","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/404/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}/get/responses/500/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all":{"value":{"message":"Contact admin@atko.com for any additional assistance needed with this request."},"key":"When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","summary":"When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all","description":"Add request message for authenticated user visible to all","id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message visible for everyone with access to the request |tooltip| Add request message for authenticated user visible to all"},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver.":{"value":{"message":"Find information about our access request policies here https://<company-internal-wiki-1>"},"key":"When embedding a reference to another application |tooltip| Including a link to another system for an approver.","summary":"When embedding a reference to another application |tooltip| Including a link to another system for an approver.","description":"Including a link to another system for an approver.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When embedding a reference to another application |tooltip| Including a link to another system for an approver."},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request.":{"value":{"message":"This access created as part of Sally's onboarding packet. Please ensure you have review company guidelines on application access located at: - https://<company-internal-wiki-1> - https://<company-internal-wiki-2> - https://<company-internal-wiki-3> - https://<company-internal-wiki-5> - https://<company-internal-wiki-6> - https://<company-internal-wiki-7> - https://<company-internal-wiki-8> - https://<company-internal-wiki-9> - https://<company-internal-wiki-10> - https://<company-internal-wiki-11> - https://<company-internal-wiki-12> - https://<company-internal-wiki-13> - https://<company-internal-wiki-14> - https://<company-internal-wiki-15> - https://<company-internal-wiki-16> - https://<company-internal-wiki-17> - https://<company-internal-wiki-18> - https://<company-internal-wiki-19> - https://<company-internal-wiki-20> - https://<company-internal-wiki-21> - https://<company-internal-wiki-22> - https://<company-internal-wiki-23> - https://<company-internal-wiki-24> - https://<company-internal-wiki-25> - https://<company-internal-wiki-25> - https://<company-internal-wiki-27> - https://<company-internal-wiki-28> - https://<company-internal-wiki-29> - https://<company-internal-wiki-30> - https://<company-internal-wiki-31> - https://<company-internal-wiki-32> - https://<company-internal-wiki-34> - https://<company-internal-wiki-35> - https://<company-internal-wiki-36> - https://<company-internal-wiki-37> - https://<company-internal-wiki-38> - https://<company-internal-wiki-39> - https://<company-internal-wiki-40> - https://<company-internal-wiki-42> - https://<company-internal-wiki-43> - https://<company-internal-wiki-44> - https://<company-internal-wiki-45> - https://<company-internal-wiki-46> - https://<company-internal-wiki-47> - https://<company-internal-wiki-48> - https://<company-internal-wiki-49> - https://<company-internal-wiki-50> - https://<company-internal-wiki-51> - https://<company-internal-wiki-52> - https://<company-internal-wiki-53> - https://<company-internal-wiki-54> - https://<company-internal-wiki-55> - https://<company-internal-wiki-56> - https://<company-internal-wiki-57> - https://<company-internal-wiki-58> - https://<company-internal-wiki-59> - https://<company-internal-wiki-60> - https://<company-internal-wiki-61> - https://<company-internal-wiki-62> - https://<company-internal-wiki-63> - https://<company-internal-wiki-64> - https://<company-internal-wiki-65> - https://<company-internal-wiki-66> - https://<company-internal-wiki-67> - https://<company-internal-wiki-68> - https://<company-internal-wiki-69> - https://<company-internal-wiki-70> - https://<company-internal-wiki-71> - https://<company-internal-wiki-72> - https://<company-internal-wiki-73> - https://<company-internal-wiki-74> - https://<company-internal-wiki-75> - https://<company-internal-wiki-76> - https://<company-internal-wiki-77> - https://<company-internal-wiki-78> - https://<company-internal-wiki-79> - https://<company-internal-wiki-80> - https://<company-internal-wiki-81> - https://<company-internal-wiki-82> - https://<company-internal-wiki-83> - https://<company-internal-wiki-84> - https://<company-internal-wiki-85> - https://<company-internal-wiki-86> - https://<company-internal-wiki-87> - https://<company-internal-wiki-88> - https://<company-internal-wiki-89> - https://<company-internal-wiki-90> - https://<company-internal-wiki-91> - https://<company-internal-wiki-92> - https://<company-internal-wiki-93> - https://<company-internal-wiki-94> - https://<company-internal-wiki-95> - https://<company-internal-wiki-96> - https://<company-internal-wiki-97> - https://<company-internal-wiki-98> - https://<company-internal-wiki-99>"},"key":"When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request.","summary":"When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request.","description":"A very long message programmatically added to the request.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/requestBody/content/application~1json/examples/When creating a request message approaching the maximum length limit |tooltip| A very long message programmatically added to the request."},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error.":{"value":{"errorCode":"E0000004","errorSummary":"Authentication failed.","errorLink":"E0000004","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"key":"When the API token is invalid, the response body contains an error.","summary":"When the API token is invalid, the response body contains an error.","id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/401/content/application~1json/examples/When the API token is invalid, the response body contains an error."},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example":{"value":{"errorCode":"E0000047","errorSummary":"The API call exceeded the rate limit due to too many requests.","errorLink":"E0000047","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/429/content/application~1json/example"},"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example":{"value":{"errorCode":"E0000009","errorSummary":"Internal Server Error","errorLink":"E0000009","errorId":"oaeWCGz73hpRCG75VHP6-RRXw","errorCauses":[]},"id":"paths/~1governance~1api~1v1~1requests~1{requestId}~1messages/post/responses/500/content/application~1json/example"}},"securitySchemeStore":{"OAuth2":{"id":"OAuth2","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as the value of the Authorization header: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer {access_token}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://developer.okta.com/docs/guides/implement-oauth-for-okta-serviceapp/main/#make-a-request"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Make a request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"flows":{"authorizationCode":{"authorizationUrl":"/oauth2/v1/authorize","tokenUrl":"/oauth2/v1/token","scopes":{"okta.governance.accessCertifications.manage":"Allows the app to create and manage Access Certification Campaigns","okta.governance.accessCertifications.read":"Allows the app to read information about Access Certification Campaigns and Reviews in your Okta org","okta.governance.accessRequests.manage":"Allows the app to create and manage V1 Access Requests, Request Types, and Teams","okta.governance.accessRequests.read":"Allows the app to read information about V1 Access Requests, Request Types, and Teams in your Okta org","okta.governance.entitlements.read":"Allows the app to read information about Entitlements, Entitlement bundles, and Grants","okta.governance.entitlements.manage":"Allows the app to create and manage Entitlements, Entitlement bundles, and Grants","okta.accessRequests.catalog.read":"Allows the app to read information about Access Request Catalogs in your Okta org","okta.accessRequests.condition.manage":"Allows the app to create and manage Conditions for the Access Request Resource Catalog","okta.accessRequests.condition.read":"Allows the app to read information about Conditions for the Access Request Resource Catalog","okta.accessRequests.request.manage":"Allows the app to create and manage V2 Access Requests through the Access Request Resource Catalog","okta.accessRequests.request.read":"Allows the app to read information about V2 Access Requests created through the Access Requests Resource Catalog","okta.governance.collections.manage":"Allows the app to create and manage collections","okta.governance.collections.read":"Allows the app to read information about collections in your Okta org","okta.governance.operations.read":"Allows the app to read information about asynchronous operations in your Okta org","okta.governance.riskRule.manage":"Allows the app to create and manage rules","okta.governance.riskRule.read":"Allows the app to read information about rules in your Okta org","okta.governance.resourceOwner.manage":"Allows the app to create and manage resource owners","okta.governance.resourceOwner.read":"Allows the app to read information about resource owners in your Okta org","okta.governance.labels.manage":"Allows the user to create and manage labels","okta.governance.labels.read":"Allows the user to read information about labels in your Okta org","okta.governance.securityAccessReviews.admin.manage":"Allows the admin app to create and manage security access reviews","okta.governance.securityAccessReviews.admin.read":"Allows the admin app to read information about security access reviews","okta.governance.securityAccessReviews.endUser.manage":"Allows the end-user app to create and manage security access reviews","okta.governance.securityAccessReviews.endUser.read":"Allows the end-user app to read information about security access reviews","okta.governance.principalSettings.manage":"Allows the app to create and manage governance settings for any user in your Okta org","okta.governance.principalSettings.read":"Allows the app to read information about governance settings for any user in your Okta org","okta.governance.settings.manage":"Allows the app to create and manage governance settings for your Okta org","okta.governance.settings.read":"Allows the app to read information about governance settings for your Okta org","okta.governance.delegates.read":"Allows the app to read information about delegates in your Okta org","okta.governance.reviewer.read":"Allows the end user to read information about access certification reviews assigned to them","okta.governance.reviewer.manage":"Allows the end user to manage access certification reviews assigned to them","okta.accessRequests.tasks.manage":"Allows the user to manage tasks for access requests in your Okta org","okta.accessRequests.tasks.read":"Allows the user to read information about tasks for access requests in your Okta org"}}}},"ApiKey":{"id":"ApiKey","type":"apiKey","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass the API token as the Authorization header value prefixed with SSWS: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: SSWS {API Token}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"in":"header","paramName":"Authorization"}},"servers":[{"url":"https://{yourOktaDomain}","variables":{"yourOktaDomain":{"default":"subdomain.okta.com","description":"The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains."}}}]},"options":{"hideInfoMetadata":true,"hideDownloadButtons":true,"hideReplay":true,"layout":"three-panel","sanitize":true,"codeSamples":{"languages":[{"lang":"curl"},{"lang":"C#"},{"lang":"Java"},{"lang":"JavaScript"},{"lang":"Node.js"},{"lang":"Python"},{"lang":"Go"},{"lang":"PHP"},{"lang":"Ruby"},{"lang":"Payload"}]},"feedback":{"hide":true,"settings":{"label":""}},"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/docs/api/_bundle/iga/openapi/governance-production-requests-admin-v1-reference.json?download"},{"url":"/docs/api/_bundle/iga/openapi/governance-production-requests-admin-v1-reference.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Access Requests - V1","description":"Allows customers to easily access the Okta API"}},"baseSlug":"/iga/openapi/governance-production-requests-admin-v1-reference","routesMapping":{}}