Docs Menu

Docs HomeAtlas App Services

http.patch()

On this page

  • Definition
  • Usage
  • Example
  • Parameters
  • Return Value
  • Rule Templates
  • Users Can Only Send Requests to a Specific Host
  • Requests URLs Must Include a Specific Query Parameter
  • Request Bodies Must Include a Specific Field
  • Request Bodies Must Include Fields with Specific Values
http.patch()

Sends an HTTP PATCH request to the specified URL using the Atlas App Services HTTP Service.

If you need to specify the individual components of the request's target URL, omit the url field and specify the components as root-level fields. The following URL component fields are available:

<scheme>://<host>/<path>?<query>#<fragment>
{
"scheme": <string>,
"host": <string>,
"path": <string>,
"query": <document>,
"fragment": <string>,
"username": <string>,
"password": <string>
}
Name
Contents
scheme
Optional. Default: "http".
Valid options: https, http

The URL scheme.

Example

// https://www.example.com/
{ scheme: "https" }
host
Required.

The hostname of the target resource.

Example

// https://www.example.com/
{ host: "www.example.com" }
path
Optional.

The path of the target resource.

Example

// https://www.example.com/api/v1/users
{ path: "/api/v1/users" }
query
Optional.

A document where each field maps to a parameter in the URL query string. The value of each field is an array of strings that contains all arguments for the parameter.

Example

// https://www.example.com/?id=8675309&color=red&color=blue
{
query: {
"id": ["8675309"],
"color": ["red", "blue"]
}
}
fragment
Optional.

The URL fragment. This portion of the URL includes everything after the hash (#) symbol.

Example

// https://www.example.com/?id=8675309#someFragment
{ fragment: "someFragment" }
username
Optional.

The username with which to authenticate the request. Typically, users utilize this argument with the password argument.

password
Optional.

The password with which to authenticate the request. The password should correspond to the user specified in the username argument.

The http.patch() action returns a promise that resolves to a document with the following form:

{
"status": <string>,
"statusCode": <integer>,
"contentLength": <integer>,
"headers": <document>,
"cookies": <array>,
"body": <binary>
}
Field
Type
Description
status
string
The HTTP Request status message.
statusCode
integer
The HTTP Request status code.
contentLength
integer
The number of bytes returned in the response body.
headers
document

A document where each field name corresponds to a type of HTTP header and each field value is an array of one or more string values for that header.

Example

{
"Content-Type": [ "application/json" ]
}
cookies
document

A document where each field name corresponds to a cookie name, and each field value is that cookie's string value.

Example

{
"favoriteTeam": "Chicago Cubs"
}
body
binary
The binary-encoded body of the HTTP response.

You can authenticate an outbound HTTP request using one of the standard HTTP authentication schemes. Atlas App Services supports the following authentication schemes:

HTTP basic authentication requires that incoming requests include a valid username and password for the requested service. You can specify the user credentials in the username and password fields of the request document, directly in a url string, or in an Authorization HTTP header.

Example

The following examples demonstrate three equivalent ways to authenticate an HTTP service request using basic authentication. The examples all use the username MyUser and the password Mypassw0rd. You would pass one of these objects as an argument to the given HTTP method.

Specify Credentials Directly (Best Method)
{
"scheme": "https",
"username": "MyUser",
"password": "Mypassw0rd",
"domain": "www.example.com"
}
Embed Credentials in the URL
{
"url": "https://MyUser:Mypassw0rd@www.example.com"
}
Include an Authorization Header
{
"url": "https://www.example.com",
"headers": {
"Authorization": [
`Basic ${BSON.Binary.fromText("MyUser:Mypassw0rd").toBase64()}`
]
}
}

HTTP digest authentication requires that incoming requests include an authorization key based on a random nonce value returned from the server. App Services can automatically construct the key and authorize requests given a valid username and password.

To configure a request to use digest authentication, set the digestAuth field to true and specify the user credentials in the username and password fields of the request document or directly in a url string.

Example

The following examples demonstrate two equivalent ways to authenticate an HTTP service request using digest authentication. The examples all use the username MyUser and the password Mypassw0rd.

Specify Credentials Directly (Best Method)
{
"scheme": "https",
"username": "MyUser",
"password": "Mypassw0rd",
"domain": "www.example.com",
"digestAuth": true
}
Embed Credentials in the URL
{
"url": "https://MyUser:Mypassw0rd@www.example.com",
"digestAuth": true
}
{
"%%args.url.host": "example.com"
}
{
"%%args.url.query.someParameter": "importantValue"
}
{
"body.name": { "%exists": 1 }
}
{
"body.city": "New York City"
}
←  http.put()http.delete() →