mirror of
https://github.com/LukeHagar/developer.sailpoint.com.git
synced 2025-12-11 04:19:42 +00:00
45 lines
15 KiB
Plaintext
45 lines
15 KiB
Plaintext
---
|
|
id: create-password-update-workflow
|
|
sidebar_label: Create a password reset workflow
|
|
hide_title: true
|
|
hide_table_of_contents: true
|
|
api: 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
|
|
sidebar_class_name: "post api-method"
|
|
info_path: docs/api/nerm/v1/nerm-api
|
|
custom_edit_url: "https://github.com/sailpoint-oss/developer.sailpoint.com/issues/new?assignees=&labels=&template=bug-report.md&title=%5BBug%5D+Your+Bug+Report+Here Requesting changes to 'Create a password reset workflow' (create-password-update-workflow)"
|
|
---
|
|
|
|
import ApiTabs from "@theme/ApiTabs";
|
|
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
|
|
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
|
|
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
|
|
import MimeTabs from "@theme/MimeTabs";
|
|
import ParamsItem from "@theme/ParamsItem";
|
|
import ResponseSamples from "@theme/ResponseSamples";
|
|
import SchemaItem from "@theme/SchemaItem";
|
|
import SchemaTabs from "@theme/SchemaTabs";
|
|
import TabItem from "@theme/TabItem";
|
|
|
|
<h1 className={"openapi__heading"}>Create a password reset workflow</h1>
|
|
|
|
<MethodEndpoint method={"post"} path={"/workflows/password_reset_workflows"}></MethodEndpoint>
|
|
|
|
|
|
|
|
Create a password reset workflow
|
|
|
|
## Request
|
|
|
|
<MimeTabs className={"openapi-tabs__mime"}><TabItem label={"application/json"} value={"application/json-schema"}><details style={{}} className={"openapi-markdown__details mime"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-mime"}><h3 className={"openapi-markdown__details-summary-header-body"}>Body</h3><strong className={"openapi-schema__required"}>required</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>workflow</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"profile_type_id"} required={false} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","required":true,"description":"The profile type the workflow effects.","example":"33f072dd-13b4-41e1-8ea0-16f2a59b57c8"}}></SchemaItem><SchemaItem collapsible={false} name={"status"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`Enabled`, `Disabled`]"} schema={{"type":"string","enum":["Enabled","Disabled"],"required":true,"description":"Whether or not the workflow is enabled or disabled.","example":"Enabled"}}></SchemaItem><SchemaItem collapsible={false} name={"uid"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","required":true,"description":"The uid of the workflow.","example":"my_uid"}}></SchemaItem><SchemaItem collapsible={false} name={"name"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","required":true,"description":"Name of the workflow","example":"my_workflow"}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>options</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"expiration_time"} required={false} schemaName={"int32"} qualifierMessage={"**Possible values:** `>= 1`"} schema={{"type":"integer","format":"int32","minimum":1,"description":"Used for login/password reset for when the password will expire.","example":1}}></SchemaItem></div></details></SchemaItem></div></details></SchemaItem></ul></details></TabItem></MimeTabs><div><div><ApiTabs><TabItem label={"200"} value={"200"}><div>
|
|
|
|
Expected response to a valid request
|
|
|
|
</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>workflow</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"id"} required={false} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","readOnly":true}}></SchemaItem><SchemaItem collapsible={false} name={"uid"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** `>= 32 characters` and `<= 32 characters`"} schema={{"type":"string","minLength":32,"maxLength":32,"readOnly":true}}></SchemaItem><SchemaItem collapsible={false} name={"workflow_id"} required={false} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid"}}></SchemaItem><SchemaItem collapsible={false} name={"requester_id"} required={false} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid"}}></SchemaItem><SchemaItem collapsible={false} name={"requester_type"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`User`, `NeprofileUser`, `NeaccessUser`]"} schema={{"type":"string","enum":["User","NeprofileUser","NeaccessUser"]}}></SchemaItem><SchemaItem collapsible={false} name={"profile_id"} required={false} schemaName={"uuid"} qualifierMessage={undefined} schema={{"type":"string","format":"uuid","description":"The profile this workflow session will be working with. Only Applicable for Update workflows"}}></SchemaItem><SchemaItem collapsible={false} name={"profile_ids"} required={false} schemaName={"uuid[]"} qualifierMessage={undefined} schema={{"type":"array","items":{"type":"string","format":"uuid"},"description":"The profiles this workflow session will be working with. Only Applicable for Batch workflows"}}></SchemaItem><SchemaItem collapsible={false} name={"status"} required={false} schemaName={"string"} qualifierMessage={"**Possible values:** [`api_request_sent`, `approved`, `assigned`, `attempting_to_start_workflow`, `AUTH-STATUS1`, `AUTH-STATUS2`, `AUTH-STATUS3`, `AUTH-STATUS4`, `AUTH-STATUS5`, `AUTH-STATUS6`, `AUTH-STATUS7`, `AUTH-STATUS8`, `AUTH-STATUS9`, `auto_assigned`, `batch_completed`, `checking_for_duplicates`, `closed`, `completed`, `courion_add`, `courion_extend`, `courion_terminate`, `courion_update`, `duplicates_resolved`, `failed`, `fulfilled`, `invitation_sent`, `ldap_provided`, `new`, `non_employee_created`, `non_employee_updated`, `notified`, `pending_approval`, `pending_assignment`, `pending_courion_add`, `pending_courion_extend`, `pending_courion_terminate`, `pending_courion_update`, `pending_creation`, `pending_fulfillment`, `pending_ldap`, `pending_notification`, `pending_profile_select`, `pending_request`, `pending_review`, `pending_status_change`, `pending_stored_procedure`, `pending_trigger`, `pending_update`, `processing`, `profile_check_complete`, `profiles_selected`, `rejected`, `requested`, `reviewed`, `soap_request_sent`, `started_workflow`, `status_changed`, `stored_procedure`, `un_assigned`, `waiting_on_workflow`, `workflow_changed`]"} schema={{"type":"string","enum":["api_request_sent","approved","assigned","attempting_to_start_workflow","AUTH-STATUS1","AUTH-STATUS2","AUTH-STATUS3","AUTH-STATUS4","AUTH-STATUS5","AUTH-STATUS6","AUTH-STATUS7","AUTH-STATUS8","AUTH-STATUS9","auto_assigned","batch_completed","checking_for_duplicates","closed","completed","courion_add","courion_extend","courion_terminate","courion_update","duplicates_resolved","failed","fulfilled","invitation_sent","ldap_provided","new","non_employee_created","non_employee_updated","notified","pending_approval","pending_assignment","pending_courion_add","pending_courion_extend","pending_courion_terminate","pending_courion_update","pending_creation","pending_fulfillment","pending_ldap","pending_notification","pending_profile_select","pending_request","pending_review","pending_status_change","pending_stored_procedure","pending_trigger","pending_update","processing","profile_check_complete","profiles_selected","rejected","requested","reviewed","soap_request_sent","started_workflow","status_changed","stored_procedure","un_assigned","waiting_on_workflow","workflow_changed"],"example":"completed"}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><span className={"openapi-schema__container"}><strong className={"openapi-schema__property"}>attributes</strong><span className={"openapi-schema__name"}> object</span></span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem name={"property name*"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string"}} collapsible={false} discriminator={false}></SchemaItem></div></details></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n \"workflow\": {\n \"id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"uid\": \"string\",\n \"workflow_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"requester_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"requester_type\": \"User\",\n \"profile_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\",\n \"profile_ids\": [\n \"3fa85f64-5717-4562-b3fc-2c963f66afa6\"\n ],\n \"status\": \"completed\",\n \"attributes\": {\n \"text_attribute_uid\": \"static text\",\n \"date_attribute_uid\": \"01/15/2020\",\n \"profile_select_attribute_uid\": \"Profile Name\",\n \"multiple_profile_select_attribute_uid\": \"Profile Name,Second Profile Name,Third Profile Name\",\n \"contributor_select_attribute_uid\": \"User Name\",\n \"multiple_contributor_select_attribute_uid\": \"User Name,Second User Name,Third User Name\"\n }\n }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"400"} value={"400"}><div>
|
|
|
|
Bad Request - unable to complete.
|
|
|
|
</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><div><span className={"badge badge--info"}>oneOf</span><SchemaTabs><TabItem label={"InvalidJson"} value={"0-item-properties"}><SchemaItem collapsible={false} name={"error"} required={false} schemaName={""} qualifierMessage={undefined} schema={{"example":"Invalid JSON syntax. Please check your syntax and try again."}}></SchemaItem></TabItem><TabItem label={"ValidationErrors"} value={"1-item-properties"}><SchemaItem collapsible={false} name={"error"} required={false} schemaName={""} qualifierMessage={undefined} schema={{"example":"The <object> failed to create/update"}}></SchemaItem><SchemaItem collapsible={false} name={"errors"} required={false} schemaName={""} qualifierMessage={undefined} schema={{"example":{"attribute":"can't be blank"}}}></SchemaItem></TabItem></SchemaTabs></div></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"500"} value={"500"}><div>
|
|
|
|
Internal Server Error - returned on unhandled exceptions.
|
|
|
|
</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details response"} data-collapsed={false} open={true}><summary style={{}} className={"openapi-markdown__details-summary-response"}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"error"} required={false} schemaName={""} qualifierMessage={undefined} schema={{"description":"A message describing the error","example":"Sorry something went wrong"}}></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n \"error\": \"Sorry something went wrong\"\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div> |