Fleet

Refuel Ship

Refuel your ship by buying fuel from the local market.

Requires the ship to be docked in a waypoint that has the Marketplace trait, and the market must be selling fuel in order to refuel.

Each fuel bought from the market replenishes 100 units in your ship's fuel.

Ships will always be refuel to their frame's maximum fuel capacity when using this action.

post/my/ships/{shipSymbol}/refuel

Path parameters

shipSymbolstring required

The ship symbol.

Request body

unitsinteger

The amount of fuel to fill in the ship's tanks. When not specified, the ship will be refueled to its maximum fuel capacity. If the amount specified is greater than the ship's remaining capacity, the ship will only be refueled to its maximum fuel capacity. The amount specified is not in market units but in ship fuel units.

fromCargoboolean

Wether to use the FUEL thats in your cargo or not. Default: false

Example request

{
  "units": 100
}

Response

Refueled successfully.

Changes

Changed in 7 of the 50 revisions of this API.228

    • added the optional property / to the response with the status

      response-optional-property-added

    • added the new path request parameter shipSymbol

      new-request-path-parameter

    • added the new optional request property

      new-optional-request-property

    • added optional request body

      request-body-added-optional

    • api tag Fleet added

      api-tag-added

    • api tag fleet removed

      api-tag-removed

    • endpoint added

      endpoint-added

  • 86f8c56c4690122See the full diff
    • removed the request body

      request-body-removed

    • deleted the path request parameter shipSymbol

      request-parameter-removed

    • removed the optional property / from the response with the status

      response-optional-property-removed

    • api tag fleet added

      api-tag-added

    • api tag Fleet removed

      api-tag-removed

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 50 revisions, 2 have no diff computed.