---
title: "Create Chart"
method: POST
path: "/my/ships/{shipSymbol}/chart"
tags: ["Fleet"]
---

# Create Chart

`POST /my/ships/{shipSymbol}/chart`

Command a ship to chart the waypoint at its current location.

Most waypoints in the universe are uncharted by default. These waypoints have their traits hidden until they have been charted by a ship.

Charting a waypoint will record your agent as the one who created the chart, and all other agents would also be able to see the waypoint's traits. Charting a waypoint gives you a one time reward of credits based on the rarity of the waypoint's traits.

## Path parameters

- `shipSymbol` string, required

## Response `201`

Created

- object
  - `data` object, required
    - `chart` ChartJson, required — unresolved $ref
    - `waypoint` WaypointJson, required — unresolved $ref
    - `agent` AgentJson, required — unresolved $ref

## Changes

> 50 revisions in range; 2 not diffed.

- **2026-07-13** `197cf9b9a2b6` — 1 info
  - added the required property `data/agent` to the response with the `201` status
- **2025-02-06** `a4500b4e7ef1` — 1 breaking
  - added the new path request parameter `shipSymbol`
- **2023-06-09** `735393b679c5` — 2 info
  - api tag `Fleet` added
  - api tag `fleet` removed
- **2023-05-23** `252df2c2fc84` — 1 info
  - endpoint added
- **2023-05-20** `86f8c56c4690` — 1 breaking, 1 warning, 2 info
  - removed the required property `data/agent` from the response with the `201` status
  - deleted the `path` request parameter `shipSymbol`
  - api tag `fleet` added
  - api tag `Fleet` removed

[Change history](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/changes/my/ships/:shipSymbol/chart/post.md)

---

[API](https://skmtc.dev/spacetradersapi/apis/spacetraders-api.md) · [All operations](https://skmtc.dev/spacetradersapi/apis/spacetraders-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/197cf9b9a2b6/schema)