{ "opencollection": "1.0.0", "info": { "name": "VTex Anti-fraud Provider Account Documents API", "version": "1.0" }, "items": [ { "info": { "name": "Documents", "type": "folder" }, "items": [ { "info": { "name": "VTex Create new document", "type": "http" }, "http": { "method": "POST", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "_schema", "value": "", "type": "query", "description": "Name of the [schema](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) that the document complies with. This field is required when using `_where` or `_fields` query parameters." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new document with an ID automatically generated by VTEX, corresponding to a new or existing data entity. If an unexisting `dataEntityName` is informed in the path, this endpoint will create the data entity as well as the new document. For example, you can create a new customer profile or address.\r\n\r\n>ℹ️ You can use this request to create documents for any data entity. Because of this, you are not restricted to using the fields exemplified below in your requests. However you should be a" }, { "info": { "name": "VTex Create partial document", "type": "http" }, "http": { "method": "PATCH", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "_schema", "value": "", "type": "query", "description": "Name of the [schema](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) that the document complies with. This field is required when using `_where` or `_fields` query parameters." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This request allows you to partially update a document corresponding to a given data entity.\r\n\r\n>ℹ️ You can use this request to create documents for any given data entity. Because of this, you are not restricted to using the fields exemplified below in your requests. But you should be aware of the fields allowed or required for each document you wish to update.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) mu" }, { "info": { "name": "VTex Get document", "type": "http" }, "http": { "method": "GET", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents/:id", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "id", "value": "", "type": "path", "description": "ID of the Document." }, { "name": "_fields", "value": "", "type": "query", "description": "Fields that should be returned by document. Separate fields' names with commas. For example `_fields=email,firstName,document`. You can also use `_fields=_all` to fetch all fields." }, { "name": "_schema", "value": "", "type": "query", "description": "Name of the [schema](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) that the document complies with. This field is required when using `_where` or `_fields` query parameters." } ] }, "docs": "Retrieves a document by ID.\n\r\n\r>ℹ️ Assign the `_fields` parameter in the query string to retrieve the desired fields. If you want to return all the fields use `_fields=_all`.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this " }, { "info": { "name": "VTex Create document with custom ID or Update entire document", "type": "http" }, "http": { "method": "PUT", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents/:id", "headers": [ { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "_where", "value": "", "type": "query", "description": "Defines a clause the document must comply with." }, { "name": "_schema", "value": "", "type": "query", "description": "Name of the [schema](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) that the document complies with. This field is required when using `_where` or `_fields` query parameters." }, { "name": "id", "value": "", "type": "path", "description": "ID of the document. If you inform an **unused ID**, this endpoint will create a new document with the informed custom ID, differently from the [Create new document](https://developers.vtex.com/docs/api-reference/master-data-api-v2#post-/api/dataentities/-dataEntityName-/documents) endpoint, which automatically generates the ID. If you inform an **existing ID**, this endpoint will update the entire document associated with the informed ID." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new document with a custom ID, or updates an entire document if there is already a document with the informed ID. For example, you can update a customer profile or address.\r\n\r\n>ℹ️ You can use this request to create or update documents in any given data entity. Because of this, you are not restricted to using the fields exemplified below in your requests. But you should be aware of the fields allowed or required for each document you wish to update.\r\n\r\nA## Permissions\r\n\r\nAny user or [ap" }, { "info": { "name": "VTex Update partial document", "type": "http" }, "http": { "method": "PATCH", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents/:id", "headers": [ { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "_where", "value": "", "type": "query", "description": "Defines a clause the document must comply with." }, { "name": "_schema", "value": "", "type": "query", "description": "Name of the [schema](https://developers.vtex.com/docs/guides/master-data-schema-lifecycle) that the document complies with. This field is required when using `_where` or `_fields` query parameters." }, { "name": "id", "value": "", "type": "path", "description": "ID of the Document." } ], "body": { "type": "json", "data": "{}" } }, "docs": "This request allows you to partially update a document corresponding to a given data entity. For example, you can update some fields of a customer profile or address.\r\n\r\n>ℹ️ You can use this request to update documents for any given data entity. Because of this, you are not restricted to using the fields exemplified below in your requests. But you should be aware of the fields allowed or required for each document you wish to update.\r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://dev" }, { "info": { "name": "VTex Delete document", "type": "http" }, "http": { "method": "DELETE", "url": "https://{providerApiEndpoint}/api/dataentities/:dataEntityName/documents/:id", "headers": [ { "name": "Content-Type", "value": "" }, { "name": "Accept", "value": "" } ], "params": [ { "name": "dataEntityName", "value": "", "type": "path", "description": "Name of the data entity." }, { "name": "id", "value": "", "type": "path", "description": "ID of the Document." } ] }, "docs": "Deletes a document. \r\n\r\n## Permissions\r\n\r\nAny user or [application key](https://developers.vtex.com/docs/guides/api-authentication-using-application-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:\r\n\r\n| **Product** | **Category** | **" } ] } ], "bundled": true }