{"id":5958,"date":"2026-02-19T14:37:24","date_gmt":"2026-02-19T13:37:24","guid":{"rendered":"https:\/\/www.trans.eu\/api\/?p=5958"},"modified":"2026-05-20T14:12:15","modified_gmt":"2026-05-20T12:12:15","slug":"refresh-publication","status":"publish","type":"post","link":"https:\/\/www.trans.eu\/api\/freights-section\/refresh-publication\/","title":{"rendered":"Refresh publication"},"content":{"rendered":"\n
\n
\n

Active freight pub\u00adli\u00adca\u00adtions can be refreshed every 15 min\u00adutes, updat\u00ading the pub\u00adli\u00adca\u00adtion date. Refreshed freight will appear on the top of freight offers list, with\u00adout the need to add a new freight.
Method is avail\u00adable for freights pub\u00adlished to Trans.eu Freight Exchange and pri\u00advate exchanges.<\/p>\n\n\n\n\n\n\n\n

The freight-id<\/code> iden\u00adti\u00adfi\u00adca\u00adtion num\u00adber in method call can be tak\u00aden from response after cre\u00adat\u00ading the freight or by down\u00adload\u00ading the freight list.<\/p>\n<\/div>\n\n\n\n

\n
PUT<\/strong>
\/ext\/freights-api\/v1\/freights\/{freight-id}\/refresh_publication
PUT<\/strong>
\/ext\/private-exchange-api\/v1\/exchange\/{freight-id}\/refresh-publication
PUT<\/strong>
\/ext\/corporate-exchange-api\/v1\/corporate-exchange\/{freight-id}\/refresh-publication
<\/pre>\n<\/div>\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
\n
\n
 Request Authorization<\/h6>\n<\/div>\n\n\n\n
\n
Every request MUST include a valid access token obtained dur\u00ading the user autho\u00adriza\u00adtion process<\/a>, pro\u00advid\u00aded using the Bear\u00ader token scheme in the Autho\u00adriza\u00adtion head\u00ader.<\/p>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Request<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Request Head\u00ader<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Successful Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Response Fields<\/a><\/p>\n<\/div>\n\n\n\n
\n
Response Body<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
 Error Response<\/h6>\n<\/div>\n\n\n\n
\n
\n
\n
Client errors (400)<\/a><\/p>\n<\/div>\n\n\n\n
\n
Gen\u00ader\u00adal API errors<\/a><\/p>\n<\/div>\n\n\n\n
\n
<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Request Header<\/h6>\n<\/div>\n\n\n\n
\n
PUT \/ext\/freights-api\/v1\/freights\/{freight-id}\/refresh_publication HTTP\/1.1 \nHost: api.platform.trans.eu \nContent-Type: application\/json\nAccept: application\/json\nAuthorization: Bearer {access_token) \nApi-key: {unique_app_api-key}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Response Fields<\/h6>\n\n\n\n
Attribute<\/td>Type<\/td>Exam\u00adple<\/td>Descrip\u00adtion<\/td><\/tr>
has_been_queued<\/td>Boolean<\/td>False<\/td>A mark\u00ader of whether the refresh request has been accept\u00aded and queued (True) or has already been exe\u00adcut\u00aded (False).<\/td><\/tr>
refresh_from<\/td>String<\/td>\u201c2025\u201309-10T10:58:08+01:00\u201d<\/td>Next pos\u00adsi\u00adble refresh date<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n
\n
Response Body<\/h6>\n<\/div>\n\n\n\n
\n
{\n    \"has_been_queued\": false,\n    \"refresh_from\": \"2026-02-10T10:58:08+01:00\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
Client errors (code 400)<\/h4>\n\n\n\n
HTTP 4xx sta\u00adtus codes indi\u00adcate client errors, mean\u00ading that the request could not be processed due to an issue on the client side. Below is a list of request-spe\u00adcif\u00adic errors.<\/p>\n\n\n\n
\n
\n
Example error 1<\/h6>\n\n\n\n
Freight does not exists<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Freight not found (id: 381781011)\",\n    \"status\": 404,\n    \"title\": \"Not Found\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 2<\/h6>\n\n\n\n
Incor\u00adrect freight sta\u00adtus to refresh<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"message\": \"Freight is not published\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n\n\n\n
\n
\n
Example error 3<\/h6>\n\n\n\n
Refresh\u00ading to ear\u00adly<\/p>\n<\/div>\n\n\n\n
\n
{\n    \"detail\": \"Refresh unavailable (id: 3293567), last refresh was at '2026-02-10T10:42:02+01:00', available from: '2026-02-10T10:57:02+01:00'\",\n    \"refresh_from\": \"2026-02-10T10:57:02+01:00\",\n    \"status\": 422,\n    \"title\": \"Unprocessable Entity\",\n    \"type\": \"http:\/\/www.w3.org\/Protocols\/rfc2616\/rfc2616-sec10.html\"\n}<\/code><\/pre><\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Active freight pub\u00adli\u00adca\u00adtions can be refreshed every 15 min\u00adutes, updat\u00ading the pub\u00adli\u00adca\u00adtion date. Refreshed freight will appear on the top \u2026<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"wp_typography_post_enhancements_disabled":false,"footnotes":""},"categories":[141,145],"tags":[],"class_list":["post-5958","post","type-post","status-publish","format-standard","hentry","category-freights-section","category-publication-n"],"acf":[],"aioseo_notices":[],"lang":"en","translations":{"en":5958},"pll_sync_post":[],"_links":{"self":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5958","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/comments?post=5958"}],"version-history":[{"count":7,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5958\/revisions"}],"predecessor-version":[{"id":6670,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/posts\/5958\/revisions\/6670"}],"wp:attachment":[{"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/media?parent=5958"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/categories?post=5958"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.trans.eu\/api\/wp-json\/wp\/v2\/tags?post=5958"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}