> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/static-spec-test/data-and-dmrv/external.md).

# External

## Sends data from an external source.

> Sends data from an external source.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"external"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"paths":{"/external/{policyId}/{blockTag}":{"post":{"description":"Sends data from an external source.","operationId":"ExternalApi_receiveExternalDataCustom","parameters":[{"name":"policyId","required":true,"in":"path","description":"Target policy identifier","schema":{"type":"string"}},{"name":"blockTag","required":true,"in":"path","description":"Target block tag in policy","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Object that contains a VC Document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalDocumentDTO"}}}},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"type":"boolean"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Sends data from an external source.","tags":["external"]}}},"components":{"schemas":{"ExternalDocumentDTO":{"type":"object","properties":{"owner":{"type":"string"},"policyTag":{"type":"string"},"document":{"nullable":false,"allOf":[{"$ref":"#/components/schemas/VcDTO"}]}},"required":["owner","policyTag","document"]},"VcDTO":{"type":"object","properties":{"id":{"type":"string","nullable":true},"@context":{"type":"array","items":{"type":"string"}},"type":{"type":"array","items":{"type":"string"}},"credentialSubject":{"additionalProperties":true,"type":"array","items":{"type":"object"}},"issuer":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"issuanceDate":{"type":"string"},"proof":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ProofDTO"}]}},"required":["id","@context","type","credentialSubject","issuer","issuanceDate","proof"]},"ProofDTO":{"type":"object","properties":{"type":{"type":"string"},"created":{"type":"string"},"verificationMethod":{"type":"string"},"proofPurpose":{"type":"string"},"jws":{"type":"string"}},"required":["type","created","verificationMethod","proofPurpose","jws"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}}}
```

## Sends data from an external source.

> Sends data from an external source.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"external"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"paths":{"/external":{"post":{"description":"Sends data from an external source.","operationId":"ExternalApi_receiveExternalData","parameters":[],"requestBody":{"required":true,"description":"Object that contains a VC Document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalDocumentDTO"}}}},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"type":"boolean"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Sends data from an external source.","tags":["external"]}}},"components":{"schemas":{"ExternalDocumentDTO":{"type":"object","properties":{"owner":{"type":"string"},"policyTag":{"type":"string"},"document":{"nullable":false,"allOf":[{"$ref":"#/components/schemas/VcDTO"}]}},"required":["owner","policyTag","document"]},"VcDTO":{"type":"object","properties":{"id":{"type":"string","nullable":true},"@context":{"type":"array","items":{"type":"string"}},"type":{"type":"array","items":{"type":"string"}},"credentialSubject":{"additionalProperties":true,"type":"array","items":{"type":"object"}},"issuer":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"issuanceDate":{"type":"string"},"proof":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ProofDTO"}]}},"required":["id","@context","type","credentialSubject","issuer","issuanceDate","proof"]},"ProofDTO":{"type":"object","properties":{"type":{"type":"string"},"created":{"type":"string"},"verificationMethod":{"type":"string"},"proofPurpose":{"type":"string"},"jws":{"type":"string"}},"required":["type","created","verificationMethod","proofPurpose","jws"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}}}
```

## Sends data from an external source.

> Sends data from an external source.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"external"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"paths":{"/external/{policyId}/{blockTag}/sync-events":{"post":{"description":"Sends data from an external source.","operationId":"ExternalApi_receiveExternalDataCustomWithSyncEvents","parameters":[{"name":"policyId","required":true,"in":"path","description":"Target policy identifier","schema":{"type":"string"}},{"name":"blockTag","required":true,"in":"path","description":"Target block tag in policy","schema":{"type":"string"}},{"name":"history","required":false,"in":"query","description":"Include execution history in sync events response","schema":{"type":"boolean"}}],"requestBody":{"required":true,"description":"Object that contains a VC Document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalDocumentDTO"}}}},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDTOWithSyncEvents"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Sends data from an external source.","tags":["external"]}}},"components":{"schemas":{"ExternalDocumentDTO":{"type":"object","properties":{"owner":{"type":"string"},"policyTag":{"type":"string"},"document":{"nullable":false,"allOf":[{"$ref":"#/components/schemas/VcDTO"}]}},"required":["owner","policyTag","document"]},"VcDTO":{"type":"object","properties":{"id":{"type":"string","nullable":true},"@context":{"type":"array","items":{"type":"string"}},"type":{"type":"array","items":{"type":"string"}},"credentialSubject":{"additionalProperties":true,"type":"array","items":{"type":"object"}},"issuer":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"issuanceDate":{"type":"string"},"proof":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ProofDTO"}]}},"required":["id","@context","type","credentialSubject","issuer","issuanceDate","proof"]},"ProofDTO":{"type":"object","properties":{"type":{"type":"string"},"created":{"type":"string"},"verificationMethod":{"type":"string"},"proofPurpose":{"type":"string"},"jws":{"type":"string"}},"required":["type","created","verificationMethod","proofPurpose","jws"]},"ResponseDTOWithSyncEvents":{"type":"object","properties":{"response":{"type":"object","nullable":true,"additionalProperties":true},"result":{"type":"object","nullable":true,"additionalProperties":true},"steps":{"additionalProperties":true,"type":"array","items":{"type":"object"}}},"required":["response","result","steps"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}}}
```

## Sends data from an external source.

> Sends data from an external source.

```json
{"openapi":"3.0.0","info":{"title":"Guardian","version":"0.0.1"},"tags":[{"name":"external"}],"servers":[{"url":"/api/v1","description":"version 1.0"}],"paths":{"/external/sync-events":{"post":{"description":"Sends data from an external source.","operationId":"ExternalApi_receiveExternalDataWithSyncEvents","parameters":[{"name":"history","required":false,"in":"query","description":"History","schema":{"type":"boolean"}}],"requestBody":{"required":true,"description":"Object that contains a VC Document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalDocumentDTO"}}}},"responses":{"200":{"description":"Successful operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseDTOWithSyncEvents"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Sends data from an external source.","tags":["external"]}}},"components":{"schemas":{"ExternalDocumentDTO":{"type":"object","properties":{"owner":{"type":"string"},"policyTag":{"type":"string"},"document":{"nullable":false,"allOf":[{"$ref":"#/components/schemas/VcDTO"}]}},"required":["owner","policyTag","document"]},"VcDTO":{"type":"object","properties":{"id":{"type":"string","nullable":true},"@context":{"type":"array","items":{"type":"string"}},"type":{"type":"array","items":{"type":"string"}},"credentialSubject":{"additionalProperties":true,"type":"array","items":{"type":"object"}},"issuer":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true}]},"issuanceDate":{"type":"string"},"proof":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ProofDTO"}]}},"required":["id","@context","type","credentialSubject","issuer","issuanceDate","proof"]},"ProofDTO":{"type":"object","properties":{"type":{"type":"string"},"created":{"type":"string"},"verificationMethod":{"type":"string"},"proofPurpose":{"type":"string"},"jws":{"type":"string"}},"required":["type","created","verificationMethod","proofPurpose","jws"]},"ResponseDTOWithSyncEvents":{"type":"object","properties":{"response":{"type":"object","nullable":true,"additionalProperties":true},"result":{"type":"object","nullable":true,"additionalProperties":true},"steps":{"additionalProperties":true,"type":"array","items":{"type":"object"}}},"required":["response","result","steps"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}}}
```