---
title: "Set My Listing"
method: PUT
path: "/record/me/listing"
tags: ["on the record"]
---

# Set My Listing

`PUT /record/me/listing`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/record/me/listing`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The writer makes their record private again, or public again after that. A record
requests publication with its first open version entry; moderation still gates reads, so this
switch is the way back; public still needs an open version, the rule the host command applies.

## Request body

- RecordListingIn
  - `listed` boolean, required

## Response `200`

Successful Response

- RecordProfileOut
  - `referral_code` string, required
  - `referral_url` string, required
  - `moderation` RecordModerationOut
    - `id` string, uuid, nullable
    - `status` 'pending' | 'approved' | 'rejected' | 'needs_review', required
    - `reason` string, required
    - `category` string, nullable
    - `content_sha256` string, required
    - `can_appeal` boolean
  - `publication_status` 'private' | 'pending' | 'published' | 'taken_down'
  - `record_id` string, uuid, required
  - `handle` string, required
  - `display_name` string, required
  - `link_url` string, nullable, required
  - `listed` boolean, required
  - `listed_at` string, date-time, nullable, required
  - `taken_down` boolean
  - `unlisted_by_writer` boolean
  - `public_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tickertrac/apis/tickerrag-api.md) · [All operations](https://skmtc.dev/tickertrac/apis/tickerrag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tickertrac/apis/tickerrag-api/revisions/3c7eb0f6425d?raw)