ServiceNow
93 min
the servicenow connector facilitates the integration of servicenow's itsm, itom, and itbm capabilities into swimlane's automated security workflows, enabling efficient incident and change management servicenow is a cloud based platform that provides solutions for it service management (itsm), it operations management (itom), and it business management (itbm) the servicenow turbine connector enables swimlane turbine users to automate incident response, service requests, and security incident management workflows by integrating with servicenow, users can streamline their security operations, enhance incident tracking, and leverage servicenow's extensive itsm capabilities directly within swimlane's low code automation platform prerequisites to effectively utilize the servicenow connector with swimlane turbine, ensure you have the following prerequisites oauth 2 0 client credentials for secure authentication url the endpoint url for servicenow api access client id the unique identifier for your registered servicenow application client secret the secret key associated with your client id to authenticate token url the url to obtain the oauth 2 0 tokens oauth 2 0 password for direct user authentication url the endpoint url for servicenow api access client id the unique identifier for your registered servicenow application client secret the secret key associated with your client id to authenticate oauth2 username your servicenow user account name oauth2 password your servicenow account password http basic authentication for simple access url the endpoint url for servicenow api access username your servicenow user account name password your servicenow account password capabilities the servicenow connector provides the following capabilities add attachment to table create incident create request create security incident create table row delete custom endpoint get all incidents get all security incidents get attachment get attachment metadata get custom endpoint get table patch custom endpoint post custom endpoint put custom endpoint and so on task setup use add a property under json body option in the action inputs screen, to add additional parameters like state , close notes , etc for creating/updating incidents or security incidents additional information about capabilities to close an incident from the update incident action, you must provide appropriate values for state, close notes, and close code a ticket can be changed from the update ticket action just by changing the state the security incident integrations will fail if the 'security incident' table is not created, see the service now documentation https //docs servicenow\ com/bundle/geneva security management/page/product/planning and policy/concept/c getstartedwithsim html for servicenow query inputs, you can use this documentation https //docs servicenow\ com/bundle/paris platform user interface/page/use/common ui elements/reference/r opavailablefiltersqueries html to format your query correctly limitations currently the only action able to retrieve work notes is the 'get journal field information' action developer notes servicenow rest api https //developer servicenow\ com/app do#!/rest api doc?v=madrid this plugin was last tested against product version paris configurations http basic authentication authenticates using username and password configuration parameters parameter description type required url a url to the target host string required username username string required password password string required verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional oauth 2 0 client credentials authenticates using oauth 2 0 client credentials configuration parameters parameter description type required url a url to the target host string required token url string required client id the client id string required client secret the client secret string required scope permission scopes for this action array optional verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional oauth 2 0 password authenticates using oauth 2 0 password configuration parameters parameter description type required url a url to the target host string required client id the client id string required client secret the client secret string required scope permission scopes for this action array optional verify ssl verify ssl certificate boolean optional http proxy a proxy to route requests through string optional oauth2 username the username for authentication string required oauth2 password the password for authentication string required actions add attachment to table adds an attachment to a specified servicenow table using the file name, table name, and system id provided endpoint url api/now/attachment/file method post input argument name type required description attachments array required file to be uploaded attachments file name string required name of the resource attachments file string required parameter for add attachment to table parameters encryption context string optional sys id of an encryption context record specify this parameter to allow only users with the specified encryption context to access the attachment parameters file name string required parameters for the add attachment to table action parameters table name string required parameters for the add attachment to table action parameters table sys id string required sys id of the record in the table specified in table name that you want to attach the file to headers object optional http headers for the request headers content type string required http headers for the request input example {"parameters" {"encryption context" "","file name" "test","table name" "incident","table sys id" "1c741bd70b2322007518478d83673af3"},"headers" {"content type" "application/json"}} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result size bytes string result of the operation result file name string name of the resource result sys mod count string result of the operation result average image color string result of the operation result image width string unique identifier result sys updated on string result of the operation result sys tags string result of the operation result table name string name of the resource result sys id string unique identifier result image height string result of the operation result sys updated by string result of the operation result download link string result of the operation result content type string type of the resource result sys created on string result of the operation result size compressed string result of the operation result compressed string result of the operation result state string result of the operation result table sys id string unique identifier result chunk size bytes string result of the operation result hash string result of the operation result sys created by string result of the operation output example {"status code" 201,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "89f9d2509783","location" "https //dev130168 service now\ com/api/now/attachment/41f9dad09783111084d57e12115 ","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chunked","date" "sat create incident initiate incident response workflows by creating a new incident record in servicenow using the provided json body endpoint url /api/now/table/incident method post input argument name type required description parameters sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields parameters sysparm exclude reference link boolean optional flag that indicates whether to exclude table api links for reference fields parameters sysparm fields string optional comma separated list of fields to return in the response parameters sysparm input display value boolean optional flag that indicates whether to set field values using the display value or the actual value parameters sysparm view string optional ui view for which to render the data determines the fields returned in the response short description string optional parameter for create incident assignment group string optional parameter for create incident urgency string optional possible values are 1 high, 2 medium, 3 low impact string optional possible values are 1 high, 2 medium, 3 low description string optional parameter for create incident input example {"parameters" {"sysparm display value" "false","sysparm exclude reference link"\ false,"sysparm fields" "","sysparm input display value"\ false,"sysparm view" ""},"json body" {"short description" "unable to connect to office wifi","assignment group" "287ebd7da9fe198100f92cc8d1d2154e","urgency" "2","impact" "2","description" "testing servicenow"}} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result parent string result of the operation result made sla string result of the operation result caused by string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result child incidents string unique identifier result hold reason string response reason phrase result origin table string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result resolved by string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation result sys domain link string result of the operation result sys domain value string value for the parameter output example {"status code" 201,"response headers" {"set cookie" "jsessionid=65cfeb1152b06972dd21833afe556414; path=/; httponly;secure, glide user ","server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "6ed13c41a300","location" "https //dev60827 service now\ com/api/now/v2/table/incident/26d1744d47603110d737c ","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","exp create request generates a new service request in servicenow with options for display value identification and input tracking endpoint url /api/now/v2/table/sc request method post input argument name type required description parameters sysparm display value boolean optional determines the type of data returned, either the actual values from the database or the display values of the fields parameters sysparm input display value boolean required flag that indicates whether to set field values using the display value or the actual value active boolean optional parameter for create request activity due string optional parameter for create request additional assignee list string optional parameter for create request approval string optional parameter for create request approval set string optional parameter for create request assigned to string optional parameter for create request assignment group string optional parameter for create request business duration string optional parameter for create request business service string optional parameter for create request calendar duration string optional parameter for create request calendar stc string optional parameter for create request close notes string optional parameter for create request closed at string optional parameter for create request closed by string optional parameter for create request cmdb ci object optional parameter for create request cmdb ci link string optional parameter for create request cmdb ci value string optional value for the parameter company string optional parameter for create request contact type string optional type of the resource contract string optional parameter for create request correlation string optional parameter for create request correlation id string optional unique identifier delivery address string optional parameter for create request input example {"parameters" {"sysparm display value"\ true,"sysparm input display value"\ true}} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result parent string result of the operation result delivery address string result of the operation result made sla string result of the operation result watch list string result of the operation result upon reject string result of the operation result requested for object result of the operation result requested for link string result of the operation result requested for value string value for the parameter result sys updated on string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result price string result of the operation result sys created on string result of the operation result sys domain object result of the operation result sys domain link string result of the operation result sys domain value string value for the parameter output example {"status code" 201,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "096cc61b9736","location" "https //dev130168 service now\ com/api/now/v2/table/sc request/896c865f9736111084 ","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chunked","date" "tue create security incident creates a new security incident in servicenow using specified path parameters endpoint url /api/now/table/{{security incident}} method post input argument name type required description path parameters security incident string required name of the security incident table sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields sysparm exclude reference link boolean optional flag that indicates whether to exclude table api links for reference fields sysparm fields string optional comma separated list of fields to return in the response sysparm input display value boolean optional flag that indicates whether to set field values using the display value or the actual value sysparm view string optional if you also specify the sysparm fields parameter, it takes precedent input example {"path parameters" {"security incident" "string"},"sysparm display value" "false","sysparm exclude reference link"\ true,"sysparm fields" "string","sysparm input display value"\ true,"sysparm view" "string"} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result parent string result of the operation result made sla string result of the operation result caused by string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result child incidents string unique identifier result hold reason string response reason phrase result origin table string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result resolved by string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation result sys domain link string result of the operation result sys domain value string value for the parameter output example {"status code" 201,"response headers" {"set cookie" "jsessionid=65cfeb1152b06972dd21833afe556414; path=/; httponly;secure, glide user ","server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "6ed13c41a300","location" "https //dev60827 service now\ com/api/now/v2/table/incident/26d1744d47603110d737c ","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","exp create table row creates a new entry in a specified servicenow table using path parameters and display values, requiring tablename, sysparm display value, and sysparm input display value endpoint url api/now/v2/table/{{tablename}} method post input argument name type required description path parameters tablename string required table name parameters sysparm display value boolean required determines the type of data returned, either the actual values from the database or the display values of the fields parameters sysparm input display value boolean required flag that indicates whether to set field values using the display value or the actual value comments string optional parameter for create table row input example {"parameters" {"sysparm display value"\ true,"sysparm input display value"\ true},"json body" {"comments" "test"},"path parameters" {"tablename" "incident"}} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result parent string result of the operation result made sla string result of the operation result caused by string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result child incidents string unique identifier result hold reason string response reason phrase result origin table string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result resolved by object result of the operation result resolved by display value string value for the parameter result resolved by link string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by display value string value for the parameter result opened by link string result of the operation result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation output example {"result" {"parent" "string","made sla" "string","caused by" "string","watch list" "string","upon reject" "string","sys updated on" "string","child incidents" "string","hold reason" "string","origin table" "string","task effective number" "string","approval history" "string","number" "string","resolved by" {"display value" "string","link" "string"},"sys updated by" "string","opened by" {"display value" "string","link" "string"}}} delete custom endpoint removes a specified custom endpoint from servicenow using the 'custom endpoint' path parameter endpoint url api/now/v2/{{custom endpoint}} method delete input argument name type required description path parameters custom endpoint string required parameters for the delete custom endpoint action data body object optional data body input example {"path parameters" {"custom endpoint" "table/incident"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" {}} get all incidents retrieves all incident records from servicenow, allowing customization of display values and result count limits endpoint url /api/now/v2/table/incident method get input argument name type required description parameters sysparm query string optional encoded query used to filter the result set you can use a ui filter to obtain a properly encoded query syntax sysparm query=\<col name> example sysparm query number=inc0000040 parameters sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields display values are manipulated based on the actual value in the database and user or system settings and preferences valid values are true returns the display values for all fields false returns the actual values from the database all returns both actual and display values parameters sysparm exclude reference link boolean optional flag that indicates whether to exclude table api links for reference fields valid values are true exclude table api links for reference fields false include table api links for reference fields parameters sysparm fields string optional comma separated list of fields to return in the response parameters sysparm limit number optional maximum number of records to return for requests that exceed this number of records, use the sysparm offset parameter to paginate record retrieval this limit is applied before acl evaluation if no records return, including records you have access to, rearrange the record order so records you have access to return first parameters sysparm no count boolean optional flag that indicates whether to execute a select count( ) query on the table to return the number of rows in the associated table valid values are true do not execute a select count( ) false execute a select count( ) parameters sysparm offset number optional starting record index for which to begin retrieving records use this value to paginate record retrieval this functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks for example, the first time you call this endpoint, sysparm offset is set to "0" to simply page through all available records, use sysparm offset=sysparm offset+sysparm limit, until you reach the end of all records don't pass a negative number in the sysparm offset parameter parameters sysparm query category string optional name of the category to use for queries parameters sysparm query no domain boolean optional flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured valid values are false exclude the record if it is in a domain that the currently logged in user is not configured to access true include the record even if it is in a domain that the currently logged in user is not configured to access parameters sysparm suppress pagination header boolean optional flag that indicates whether to remove the link header from the response the link header provides various urls to relative pages in the record set which you can use to paginate the returned record set valid values are true remove the link header from the response false do not remove the link header from the response parameters sysparm view string optional ui view for which to render the data determines the fields returned in the response valid values are desktop, mobile, both if you also specify the sysparm fields parameter, it takes precedent input example {"parameters" {"sysparm query" "number=inc0000040","sysparm display value" "false","sysparm exclude reference link"\ false,"sysparm fields" "","sysparm limit" 10000,"sysparm no count"\ false,"sysparm offset" 0,"sysparm query category" "","sysparm query no domain"\ false,"sysparm suppress pagination header"\ false,"sysparm view" "desktop"}} output parameter type description status code number http status code of the response reason string response reason phrase result array result of the operation result parent string result of the operation result made sla string result of the operation result caused by string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result child incidents string unique identifier result hold reason string response reason phrase result origin table string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result resolved by object result of the operation result resolved by link string result of the operation result resolved by value string value for the parameter result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation output example {"status code" 200,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "7d9414489707","link" "\<https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0 ","x total count" "67","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chu get all security incidents retrieves all security incident records from servicenow with display customization and pagination options, requiring a specific incident path parameter endpoint url /api/now/table/{{security incident}} method get input argument name type required description path parameters security incident string required name of the security incident table parameters sysparm query string optional encoded query used to filter the result set you can use a ui filter to obtain a properly encoded query syntax sysparm query=\<col name> example sysparm query number=inc0000040 parameters sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields display values are manipulated based on the actual value in the database and user or system settings and preferences valid values are true returns the display values for all fields false returns the actual values from the database all returns both actual and display values parameters sysparm exclude reference link boolean optional flag that indicates whether to exclude table api links for reference fields valid values are true exclude table api links for reference fields false include table api links for reference fields parameters sysparm fields string optional comma separated list of fields to return in the response parameters sysparm limit number optional maximum number of records to return for requests that exceed this number of records, use the sysparm offset parameter to paginate record retrieval this limit is applied before acl evaluation if no records return, including records you have access to, rearrange the record order so records you have access to return first parameters sysparm no count boolean optional flag that indicates whether to execute a select count( ) query on the table to return the number of rows in the associated table valid values are true do not execute a select count( ) false execute a select count( ) parameters sysparm offset number optional starting record index for which to begin retrieving records use this value to paginate record retrieval this functionality enables the retrieval of all records, regardless of the number of records, in small manageable chunks for example, the first time you call this endpoint, sysparm offset is set to "0" to simply page through all available records, use sysparm offset=sysparm offset+sysparm limit, until you reach the end of all records don't pass a negative number in the sysparm offset parameter parameters sysparm query category string optional name of the category to use for queries parameters sysparm query no domain boolean optional flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured valid values are false exclude the record if it is in a domain that the currently logged in user is not configured to access true include the record even if it is in a domain that the currently logged in user is not configured to access parameters sysparm suppress pagination header boolean optional flag that indicates whether to remove the link header from the response the link header provides various urls to relative pages in the record set which you can use to paginate the returned record set valid values are true remove the link header from the response false do not remove the link header from the response parameters sysparm view string optional ui view for which to render the data determines the fields returned in the response valid values are desktop, mobile, both if you also specify the sysparm fields parameter, it takes precedent input example {"parameters" {"sysparm query" "number=inc0000040","sysparm display value" "false","sysparm exclude reference link"\ false,"sysparm fields" "","sysparm limit" 10000,"sysparm no count"\ false,"sysparm offset" 0,"sysparm query category" "","sysparm query no domain"\ false,"sysparm suppress pagination header"\ false,"sysparm view" "desktop"},"path parameters" {"security incident" "sn si incident"}} output parameter type description status code number http status code of the response reason string response reason phrase result array result of the operation result parent string result of the operation result made sla string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result approval history string result of the operation result number string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation result sys domain link string result of the operation result sys domain value string value for the parameter result state string result of the operation result sys created by string result of the operation result knowledge string result of the operation result order string result of the operation result closed at string result of the operation result cmdb ci object result of the operation output example {"status code" 200,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "0a564c938322","x total count" "1","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chunked","date" "mon, 23 dec 2024 10 03 47 gmt","keep alive" "timeout=70","connection" "keep aliv get attachment retrieves a specific attachment from a servicenow table using the unique sys id provided endpoint url api/now/attachment/{{sys id}}/file method get input argument name type required description path parameters sys id string required sys id of the attachment record from which to return binary data input example {"path parameters" {"sys id" "1c741bd70b2322007518478d83673af3"}} output parameter type description status code number http status code of the response reason string response reason phrase file array output field file output example {"status code" 200,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "1dd293709703","content disposition" "attachment;filename=\\"test\\";filename =utf 8''test","x content type options" "nosniff","x attachment metadata" "{ \\"size bytes\\" \\"5881\\", \\"file name\\" \\"test\\", \\"sys mod count\\" \\"1\\", \\"avera ","x edge enc proxy static" "true","content type" "application/json;charset=utf 8","transfer enc get attachment metadata retrieve attachment metadata from servicenow, allowing filtering with 'sysparm query' endpoint url api/now/attachment method get input argument name type required description parameters sysparm query string required encoded query queries for the attachment api are relative to the attachments \[sys attachment] table input example {"parameters" {"sysparm query" "table sys id=1c741bd70b2322007518478d83673af3"}} output parameter type description status code number http status code of the response reason string response reason phrase result array result of the operation output example {"status code" 200,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "09ee25ec974f","x total count" "2","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chunked","date" "sat, 05 nov 2022 16 24 03 gmt","keep alive" "timeout=20","connection" "keep aliv get custom endpoint retrieves data from a specified servicenow custom endpoint using the provided 'custom endpoint' path parameter endpoint url api/now/v2/{{custom endpoint}} method get input argument name type required description path parameters custom endpoint string required parameters for the get custom endpoint action parameters display value boolean optional parameters for the get custom endpoint action parameters sysparm limit number optional parameters for the get custom endpoint action data body object optional data body input example {"parameters" {"display value"\ true,"sysparm limit" 1},"path parameters" {"custom endpoint" "table/incident"}} get table retrieves records from a specified servicenow table by utilizing the 'tablename' path parameter endpoint url api/now/v2/table/{{tablename}} method get input argument name type required description path parameters tablename string required name of the table from which to retrieve the records parameters name value pairs object optional parameters for the get table action parameters name value pairs active string optional parameters for the get table action parameters name value pairs assigned to string optional parameters for the get table action parameters name value pairs state string optional parameters for the get table action parameters sysparm display value string optional parameters for the get table action parameters sysparm exclude reference link boolean optional parameters for the get table action parameters sysparm fields string optional parameters for the get table action parameters sysparm limit number optional parameters for the get table action parameters sysparm no count boolean optional parameters for the get table action parameters sysparm offset number optional parameters for the get table action parameters sysparm query string optional parameters for the get table action parameters sysparm query category string optional parameters for the get table action parameters sysparm query no domain boolean optional parameters for the get table action parameters sysparm suppress pagination header boolean optional parameters for the get table action parameters sysparm view string optional parameters for the get table action input example {"parameters" {"name value pairs" {"active" "true","assigned to" "john smith","state" "closed"},"sysparm display value" "all","sysparm exclude reference link"\ true,"sysparm fields" "field1,field2,field3","sysparm limit" 100,"sysparm no count"\ true,"sysparm offset" 0,"sysparm query" "caller id=javascript\ gs getuserid()^active=true^orderbynumber^orderbydesccategory","sysparm query category" "category name","sysparm query no domain"\ false,"sysparm suppress pagination header"\ true,"sysparm view" "desktop"},"path parameters" {"tablename" "problem"}} output parameter type description status code number http status code of the response reason string response reason phrase result array result of the operation result parent string result of the operation result made sla string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result approval history string result of the operation result number string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by link string result of the operation result opened by value string value for the parameter result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation result sys domain link string result of the operation result sys domain value string value for the parameter result state string result of the operation result sys created by string result of the operation result knowledge string result of the operation result order string result of the operation result closed at string result of the operation result cmdb ci object result of the operation output example {"status code" 200,"response headers" {},"reason" "ok","json body" {"result" \[{}]}} patch custom endpoint apply a patch request to a custom servicenow endpoint, utilizing path parameters with the v2 api endpoint url api/now/v2/{{custom endpoint}} method patch input argument name type required description path parameters custom endpoint string required parameters for the patch custom endpoint action data body object optional data body input example {"path parameters" {"custom endpoint" "table/incident"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {},"reason" "ok","json body" {}} post custom endpoint executes a post request to a specified custom endpoint in servicenow v2, using the 'custom endpoint' path parameter endpoint url api/now/v2/{{custom endpoint}} method post input argument name type required description path parameters custom endpoint string required parameters for the post custom endpoint action parameters sysparm display value boolean optional parameters for the post custom endpoint action parameters sysparm input display value boolean optional parameters for the post custom endpoint action data body object optional data body input example {"parameters" {"sysparm display value"\ true,"sysparm input display value"\ true},"path parameters" {"custom endpoint" "table/sc request"}} put custom endpoint executes a put request to a specified servicenow custom endpoint using path parameters endpoint url api/now/v2/{{custom endpoint}} method put input argument name type required description path parameters custom endpoint string required parameters for the put custom endpoint action data body object optional data body input example {"path parameters" {"custom endpoint" "table/incident"}} servicenow get custom action executes a custom action in servicenow using specified 'mid extension' and 'end extension' path parameters to target api endpoints endpoint url api/{{mid extension}}/v2/{{end extension}} method get input argument name type required description path parameters mid extension string required parameters for the servicenow get custom action action path parameters end extension string required parameters for the servicenow get custom action action input example {"path parameters" {"mid extension" "string","end extension" "string"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"content length" "140","content type" "application/json","date" "mon, 2 sep 2024 20 37 23 gmt"},"reason" "ok","json body" {}} servicenow patch custom action executes a custom patch request in servicenow with specified 'mid extension' and 'end extension' path parameters endpoint url api/{{mid extension}}/v2/{{end extension}} method patch input argument name type required description path parameters mid extension string required parameters for the servicenow patch custom action action path parameters end extension string required parameters for the servicenow patch custom action action comments string optional parameter for servicenow patch custom action input example {"json body" {"comments" "test"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"content length" "140","content type" "application/json","date" "mon, 2 sep 2024 20 37 23 gmt"},"reason" "ok","json body" {}} servicenow post custom action executes a user defined custom action in servicenow, utilizing the 'mid extension' and 'end extension' path parameters endpoint url api/{{mid extension}}/v2/{{end extension}} method post input argument name type required description path parameters mid extension string required parameters for the servicenow post custom action action path parameters end extension string required parameters for the servicenow post custom action action comments string optional parameter for servicenow post custom action input example {"json body" {"comments" "test"}} output parameter type description status code number http status code of the response reason string response reason phrase output example {"status code" 200,"response headers" {"content length" "140","content type" "application/json","date" "mon, 2 sep 2024 20 37 23 gmt"},"reason" "ok","json body" {}} update incident updates an existing incident in servicenow using the unique sys id and additional data provided in a json body endpoint url /api/now/table/incident/{{sys id}} method patch input argument name type required description path parameters sys id string required sys id of the record to be updated sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields sysparm fields string optional comma separated list of fields to return in the response sysparm input display value boolean optional flag that indicates whether to set field values using the display value or the actual value sysparm query no domain boolean optional flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured sysparm view string optional if you also specify the sysparm fields parameter, it takes precedent input example {"path parameters" {"sys id" "string"},"sysparm display value" "false","sysparm fields" "string","sysparm input display value"\ true,"sysparm query no domain"\ true,"sysparm view" "string"} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 200,"response headers" {"set cookie" "jsessionid=cea60557841f8f77a8ab86e60b05f18d; path=/; httponly;secure, bigipserve ","server timing" "wall;dur=0, sem wait;dur=0, sesh wait;dur=0, app cpu;dur=0, db;dur=1, acl;dur=0, ","content security policy" "frame ancestors 'self' teams microsoft com teams microsoft com","content length" "0","date" "mon, 07 aug 2023 11 12 15 gmt","keep alive" "timeout=70","connection" "keep alive","server" "servicenow","strict transport security" "max update security incident updates a specified security incident in servicenow using the unique sys id as an identifier endpoint url api/now/table/{{security incident}}/{{sys id}} method patch input argument name type required description path parameters security incident string required name of the security incident table path parameters sys id string required id of the security incident to update sysparm display value string optional determines the type of data returned, either the actual values from the database or the display values of the fields sysparm fields string optional comma separated list of fields to return in the response sysparm input display value boolean optional flag that indicates whether to set field values using the display value or the actual value sysparm query no domain boolean optional flag that indicates whether to restrict the record search to only the domains for which the logged in user is configured sysparm view string optional if you also specify the sysparm fields parameter, it takes precedent input example {"path parameters" {"security incident" "string","sys id" "string"},"sysparm display value" "false","sysparm fields" "string","sysparm input display value"\ true,"sysparm query no domain"\ true,"sysparm view" "string"} output parameter type description status code number http status code of the response reason string response reason phrase response text string output field response text output example {"status code" 200,"response headers" {"set cookie" "jsessionid=0adfd22f053bcc78a9a82faf40e83d50; path=/; httponly;secure, bigipserve ","server timing" "wall;dur=0, sem wait;dur=0, sesh wait;dur=0, app cpu;dur=0, db;dur=1, acl;dur=0, ","content security policy" "frame ancestors 'self' teams microsoft com teams microsoft com","content length" "0","date" "mon, 07 aug 2023 11 18 32 gmt","keep alive" "timeout=70","connection" "close","server" "servicenow","strict transport security" "max age=6 update table row updates a specific row in a servicenow table by sys id, with customizable display value settings endpoint url api/now/v2/table/{{tablename}}/{{sys id}} method patch input argument name type required description path parameters tablename string required table name path parameters sys id string required sys id of the record to be updated parameters sysparm display value boolean required determines the type of data returned, either the actual values from the database or the display values of the fields parameters sysparm input display value boolean required flag that indicates whether to set field values using the display value or the actual value comments string optional parameter for update table row input example {"parameters" {"sysparm display value"\ true,"sysparm input display value"\ true},"json body" {"comments" "test"},"path parameters" {"tablename" "incident","sys id" "1c741bd70b2322007518478d83673af3"}} output parameter type description status code number http status code of the response reason string response reason phrase result object result of the operation result parent string result of the operation result made sla string result of the operation result caused by string result of the operation result watch list string result of the operation result upon reject string result of the operation result sys updated on string result of the operation result child incidents string unique identifier result hold reason string response reason phrase result origin table string result of the operation result task effective number string result of the operation result approval history string result of the operation result number string result of the operation result resolved by object result of the operation result resolved by display value string value for the parameter result resolved by link string result of the operation result sys updated by string result of the operation result opened by object result of the operation result opened by display value string value for the parameter result opened by link string result of the operation result user input string input data for the action result sys created on string result of the operation result sys domain object result of the operation output example {"status code" 200,"response headers" {"server timing" "sem wait;dur=0, sesh wait;dur=0","content encoding" "gzip","x is logged in" "true","x transaction id" "c2e8b1909703","x content type options" "nosniff","pragma" "no store,no cache","cache control" "no cache,no store,must revalidate,max age= 1","expires" "0","content type" "application/json;charset=utf 8","transfer encoding" "chunked","date" "fri, 04 nov 2022 22 29 20 gmt","keep alive" "timeout=20","connection" "keep alive","server" "service response headers header description example cache control directives for caching mechanisms no cache,no store,must revalidate,max age= 1 connection http response header connection keep alive content disposition http response header content disposition attachment;filename="test";filename =utf 8''test content encoding http response header content encoding gzip content length the length of the response body in bytes 140 content security policy http response header content security policy frame ancestors 'self' teams microsoft com teams microsoft com content type the media type of the resource application/json date the date and time at which the message was originated sat, 05 nov 2022 00 53 43 gmt expires the date/time after which the response is considered stale 0 keep alive http response header keep alive timeout=20 link http response header link https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=0 https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=0 ;rel="first", https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset= 1 https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset= 1 ;rel="prev", https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=1 https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=1 ;rel="next", https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=66 https //dev130168 service now\ com/api/now/v2/table/incident?query=number%3dinc0000040\&display value=true\&sysparm limit=1\&sysparm offset=66 ;rel="last" location the url to redirect a page to https //dev130168 service now\ com/api/now/attachment/41f9dad09783111084d57e121153af94/file https //dev130168 service now\ com/api/now/attachment/41f9dad09783111084d57e121153af94/file pragma http response header pragma no store,no cache server information about the software used by the origin server servicenow server timing http response header server timing wall;dur=0, sem wait;dur=0, sesh wait;dur=0, app cpu;dur=0, db;dur=1, acl;dur=0, br;dur=null, ui action;dur=0, cache build;dur=0, scripting;dur=0 set cookie http response header set cookie jsessionid=cea60557841f8f77a8ab86e60b05f18d; path=/; httponly;secure, bigipserverpool dev60827=999184138 46398 0000; path=/; httponly; secure strict transport security http response header strict transport security max age=63072000; includesubdomains transfer encoding http response header transfer encoding chunked x attachment metadata http response header x attachment metadata x content type options http response header x content type options nosniff x edge enc proxy static http response header x edge enc proxy static true x is logged in http response header x is logged in true x total count http response header x total count 2 x transaction id http response header x transaction id 89f9d2509783