Deleting expense data as multipart/form-data

Deletes data on expenses uploaded to Yandex Metrica.

Note

You can't delete the Yandex Direct data.

Data is passed as multipart/form-data within the file parameter in CSV format. Specify which data should be deleted.

Required columns:

Date: String, a date in YYYY-MM-DD format or a range of dates in YYYY-MM-DD/YYYY-MM-DD format.

Optional columns:

UTMSource: String, utm_source label value.
UTMMedium: String, utm_medium label value.
UTMCampaign: String, utm_campaign label value.
UTMTerm: String, utm_term label value.
UTMContent: String, utm_content label value.
TrafficSource: First-level traffic source. Acceptable values are given in the table.
TrafficSourceDetail: Second-level traffic source. Acceptable values are given in the table.

Note

The values of UTM tags are case-sensitive. Make sure the case is exactly the same as in the uploaded data.

Request

POST

https://api-metrika.yandex.net/management/v1/counter/{counterId}/expense/delete

Path parameters

Name

Description

counterId

Type: integer

ID of the counter for which you want to delete data.

Query parameters

Name

Description

comment

Type: string

Comment.

Example: ``

provider

Type: string

The data provider's name that could have been sent during the API upload of expenses. When the parameter value isn't specified, data for all providers will be deleted based on the conditions in the uploaded file.

Example: ``

Body

multipart/form-data

{
  "file": "example"
}

Name

Description

file

Type: string<binary>

Example: example

Responses

200 OK

Body

application/json

{
  "uploading": {
    "id": 0,
    "create_time": "2025-01-01T00:00:00Z",
    "source_quantity": 0,
    "provider": "example",
    "comment": "example",
    "type": "example",
    "status": "example"
  }
}

Name

Description

uploading

Type: ExpenseUploading

Information about expense uploads.

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "provider": "example",
  "comment": "example",
  "type": "example",
  "status": "example"
}

ExpenseUploading

Information about expense uploads.

Name	Description
comment	Type: string Comment. Example: `example`
create_time	Type: string<date-time> Upload time. Example: `2025-01-01T00:00:00Z`
id	Type: integer Upload ID.
provider	Type: string Data provider name. Example: `example`
source_quantity	Type: integer Number of rows in the source file.
status	Type: string Upload status: `UPLOADED`: Upload complete. `IN_PROGRESS`: Upload in progress. `PROCESSED`: Upload processed. Example: `example`
type	Type: string Upload type: `EXPENSES`: Expenses. `REMOVES`: Deleting expenses. Example: `example`

Example

{
  "id": 0,
  "create_time": "2025-01-01T00:00:00Z",
  "source_quantity": 0,
  "provider": "example",
  "comment": "example",
  "type": "example",
  "status": "example"
}

Was the article helpful?

Deleting expense data using a request

List of expense uploads