Servicenow

the servicenow connector enables seamless integration with servicenow's suite of services, allowing for efficient management of incidents, requests, and other it service processes servicenow is a cloud based platform that provides solutions for it service management (itsm), it operations management (itom), and it business management (itbm) this connector enables swimlane turbine users to automate incident response, manage service requests, and handle security incidents directly within servicenow by integrating with servicenow, users can streamline their security and it workflows, ensuring rapid response to incidents, efficient resource allocation, and enhanced visibility into security operations prerequisites to effectively utilize the servicenow connector with swimlane turbine, ensure you have the following prerequisites oauth 2 0 password authentication with these parameters url the endpoint url for servicenow api access client id the client identifier as registered in servicenow client secret the secret key associated with the client id oauth2 username the username for the account with access to servicenow oauth2 password the password for the account with access to servicenow oauth 2 0 client credentials authentication with these parameters url the endpoint url for servicenow api access client id the client identifier as registered in servicenow client secret the secret key associated with the client id token url the url to retrieve the oauth2 token http basic authentication with these parameters url the endpoint url for servicenow api access username the username for the account with access to servicenow password the password for the account with access to servicenow 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 https //docs servicenow\ com/bundle/geneva security management/page/product/planning and policy/concept/c getstartedwithsim html for servicenow query inputs, you can use 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 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 ca cert a base64 encoded ca certificate to use for ssl verification 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 ca cert a base64 encoded ca certificate to use for ssl verification 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 ca cert a base64 encoded ca certificate to use for ssl verification string optional actions add attachment to table adds an attachment to a servicenow table using the provided file name, table name, and system id 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, allowing 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 with the provided 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, 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 provided '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 with options to customize display values and set 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 options for display customization and pagination, using 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 provided unique sys id 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 metadata for attachments in servicenow using optional 'sysparm query' filtering 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 '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 using 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 specified custom servicenow endpoint using 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 custom endpoint in servicenow v2, specified by 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 servicenow custom endpoint defined by the user via 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 by targeting specific api endpoints with 'mid extension' and 'end extension' path parameters 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 using '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 custom action in servicenow using specified '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 using sys id, with options to customize display values 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 close 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;charset=utf 8 date the date and time at which the message was originated mon, 07 aug 2023 10 59 39 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 ;rel="first", 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 ;rel="next", 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 //dev60827 service now\ com/api/now/v2/table/incident/26d1744d47603110d737cd9bd36d436b 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 sem wait;dur=0, sesh wait;dur=0 set cookie http response header set cookie glide user=; max age=0; expires=thu, 01 jan 1970 00 00 10 gmt; path=/; httponly; samesite=none; secure, glide user session=; max age=0; expires=thu, 01 jan 1970 00 00 10 gmt; path=/; httponly; samesite=none; secure, glide user route=glide f6d1c4085a807931391acf9b7192b09e; max age=2147483647; expires=mon, 20 nov 2090 00 34 38 gmt; path=/; httponly; samesite=none; secure, glide session store=016c8ed79736111084d57e121153af34; max age=1800; expires=tue, 01 nov 2022 21 50 31 gmt; path=/; httponly; samesite=none; 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 1 x transaction id http response header x transaction id 096cc61b9736