# Http Request Block

This block for retrieving information from outside (3rd party) services via HTTP requests

## Properties

| Property Name    | Description                                                                       | Example                   |
| ---------------- | --------------------------------------------------------------------------------- | ------------------------- |
| Tag              | Unique name for the logic block.                                                  | Http\_Block               |
| Permissions      | Which entity has rights to interact at this part of the workflow.                 | Standard Registry         |
| Default Active   | Shows whether this block is active at this time and whether it needs to be shown. | Checked or Unchecked      |
| Stop Propagation | End processing here, don't pass control to the next block.                        | Checked or Unchecked      |
| On Errors        | Called if the system error has occurs in the Block                                | No Entry/Retry            |
| URL              | URL of the external service end point                                             | <http://localhost:8080>   |
| Method           | HTTP method of the request                                                        | GET/POST/DELETE/PUT/PATCH |
| Body             | Body of the HTTP request                                                          | $(document)               |
| Headers          | Additional HTTP headers (can be used for authentication purposes)                 | Bearer $(document).Source |

<figure><img src="https://3006114282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXVOaWpJKxLZf1Tee9eCO%2Fuploads%2FXKZ8dojhRvsZeMQgA8Z1%2Fimage.png?alt=media&#x26;token=158f53a0-1d66-4484-be11-b2d9107827c9" alt=""><figcaption></figcaption></figure>

## 2. Dynamic Variables

The values of the URL, Body and Header parameters  can contain variables of the format ${variable}.

Possible values are as follows:

* “did” – DID of the current user
* “username” – name of the current user
* “document” or “documents” – a single document or an array of document correspondingly, which have been passed to the block on entry


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.guardianservice.io/technical-information/users/standard-registry-users-schemas-and-policies/policies/available-policy-workflow-blocks/http-request-block.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
