Update entry

put

https://api.gobeeping.com/api/v1/client/entries/{entry_id}

Authenticate with HTTP Basic using the client credentials. Entries are scoped to the authenticated user’s current team.

Only entries in PENDIENTE status can be updated. This is a full replacement of editable fields and expected product lines: always send the complete lines array. Previous line IDs are replaced. Omitted nullable scalar fields are cleared; omitted metadata and tracking codes become empty arrays.

Each product_id may occur only once. The operation is transactional. The success response has no body. Use GET to read the updated entry.

Free-form metadata

The entry and its product lines may contain metadata: a free-form JSON object, array or null. For create and update requests, omitted or null metadata becomes an empty array. Responses include the saved metadata on the entry and each entry line. These dynamic values are shown in the JSON examples and intentionally left unexpanded in the visual schema.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

entry_id

integer

required

≥ 1

Entry ID returned by create or list entries.

Body Params

estimated_delivery_at

string | null

Estimated arrival date/time. Use YYYY-MM-DD HH:mm:ss. Dates are returned without an offset.

boxes_count

integer | null

≥ 1

description

string | null

tracking_codes

array of strings | null

Preferred tracking field. Codes are trimmed, empty codes removed and duplicates removed. When supplied as an array it takes precedence over tracking_code, including an empty array.

tracking_codes

tracking_code

string | null

deprecated

Legacy single tracking code. Used only if tracking_codes is not an array. Trimmed and truncated to 100 characters when stored. Prefer tracking_codes.

lines

array of objects

required

length ≥ 1

Complete list of expected products. Each product_id may occur only once.

lines*

product_id

integer

required

Existing product ID, available to the authenticated client. Obtain it from GET /api/v1/client/products.

qty_expected

integer

required

≥ 1

Expected number of units. Returned as expected_qty when reading an entry.

Responses

204

Entry updated successfully. No response body.

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

401Missing or invalid HTTP Basic credentials.

404Entry or product unavailable during update.

409Entry cannot be updated or a product occurs more than once.

422Request validation failed. A missing/nonexistent entry_id or product_id may be rejected here before the domain lookup. Validation messages may vary.