AI resources
Update configurations

Updates the columns, output-file settings, display timezone, and delivery notifiers of a previously configured Other Operations report. The report type is specified by reportId, and the configuration structure is identified by structureId. In case of success, the request returns a response with status 200.

PUT

https://api.mercadopago.com/v1/reporting/operations/{reportId}/config/{structureId}
Request parameters
Header
Authorization
string

REQUIRED

Access Token obtained through the developer panel. Must be sent in all requests.
Path
reportId
string

REQUIRED

Other Operations report type.
activities_collection: Collection report.
activities_after_collection: Post-collection report.
activities_withdraw: Withdrawal report.
structureId
string

REQUIRED

Structure UUID returned when creating the configuration with POST /config.
Body
structure
object

REQUIRED

Updated report structure. It must include the name and columns; send file_format and display_timezone only when you want to update those settings.
notifiers
array
This array is optional. Send it to add delivery notifiers or update the configuration of existing ones.
Response parameters
structure
object
Report structure returned after updating the configuration.
notifiers
array
Notifiers updated and associated with the report structure.
Errors

400Invalid fields.

validation_error

One or more configuration fields are invalid. Check the structure fields and the notifier data; when updating an existing notifier, include its id. Then submit the request again.

401Invalid access token.

invalid_token

The Access Token is invalid, expired, or does not have write permissions. Check the token sent in the Authorization header and its scopes, then submit the request again.

404Configuration not found.

configuration_not_found

No configuration was found for the specified structureId. Retrieve the active configuration with GET /config, verify structure.id, and submit the update again.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/reporting/operations/{reportId}/config/{structureId}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
    -d '{
  "structure": {
    "name": "collections-structure",
    "columns": [
      {
        "key": "date_created"
      }
    ],
    "file_format": {
      "column_separator": ",",
      "decimal_separator": ".",
      "date_format": "yyyy-MM-dd",
      "name": "activities_collection",
      "prefix": "activities_"
    },
    "display_timezone": "GMT-05"
  },
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "data": {
        "server": "sftp.myserver.com",
        "port": 22,
        "username": "username",
        "password": "mypassword",
        "remote_dir": "/myfolder"
      },
      "description": "Webhook delivery"
    }
  ]
}'
Response
{
  "structure": {
    "id": "aaaabbbb-1111-2222-3333-ccccddddeeee",
    "name": "collections-structure",
    "columns": [
      {
        "key": "date_created"
      }
    ],
    "notifiers": [
      "11112222-aaaa-bbbb-cccc-333344445555"
    ],
    "scheduled": false,
    "version": 1
  },
  "notifiers": [
    {
      "id": "11112222-aaaa-bbbb-cccc-333344445555",
      "type": "webhook",
      "status": "ACTIVE",
      "version": 1
    }
  ]
}