IRPCVaultExtensionMethods.ExecuteAnonymousExtensionMethod
Vault API / standard write no session returns metadata structure version
Passes an anonymous HTTP request, such as a webhook call, to a vault application. Used by the M-Files web server.
| Service | Vault extension methods MFiles.IRPCVaultExtensionMethods |
|---|---|
| gRPC method | /MFiles.IRPCVaultExtensionMethods/ExecuteAnonymousExtensionMethod |
| HTTP (mf-http-grpc) | POST /grpc/v1/execute-anonymous-extension-method |
| Request | ExecuteAnonymousExtensionMethodRequest |
| Response | ExecuteAnonymousExtensionMethodResponse |
| Book and level | Vault API, standard |
| Kind | write |
| Session | Not needed: the call can be made before logging in. |
| Idempotent | no |
| Returns metadata structure version | yes (in the mfiles-metadata-version-bin trailer) |
| Streaming | none (unary) |
Remarks
- No session is needed. The server finds the vault by
vault_dns, which must match a host name that the server administrator has mapped to a vault; otherwise the call fails with "The parameter is incorrect.". - The method runs without a user. The receiving application must authenticate and validate the request itself.
http_pathmust not be empty and is limited to 10240 characters.http_methodmust be one of CONNECT, DELETE, GET, HEAD, OPTIONS, POST or PUT. Other values fail with "The parameter is incorrect.".
Request: ExecuteAnonymousExtensionMethodRequest
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
vault_dns | string | The host name of the vault, as mapped on the server. |
method_identifier | string | The name of the anonymous extension method. |
http_path | string | The path and query string of the HTTP request. |
http_method | string | The HTTP method of the request, for example POST. |
http_headers[] | repeated NamedValue | The headers of the HTTP request. |
http_headers[].key | string | The name of the value. |
http_headers[].value | TypedValue | The value as a serialized bytearray. |
http_headers[].value.is_null_value | bool | True if the value is empty. data is then unset. |
http_headers[].value.type | Datatype | The data type of the value. |
http_headers[].value.data | TypedValueUnion | The value, in the member that matches type. Unset for an empty value. |
request_body | bytes | The body of the HTTP request. |
Response: ExecuteAnonymousExtensionMethodResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
response_http_headers[] | repeated NamedValue | The headers to return in the HTTP response. |
response_http_headers[].key | string | The name of the value. |
response_http_headers[].value | TypedValue | The value as a serialized bytearray. |
response_http_headers[].value.is_null_value | bool | True if the value is empty. data is then unset. |
response_http_headers[].value.type | Datatype | The data type of the value. |
response_http_headers[].value.data | TypedValueUnion | The value, in the member that matches type. Unset for an empty value. |
response_body | bytes | The body of the HTTP response. |