---
title: "Create a publication"
method: POST
path: "/publications"
tags: ["Publication"]
---

# Create a publication

`POST /publications`

## Request

- Base URL: `https://telescope.ac/api`
- URL: `https://telescope.ac/api/publications`
- Auth: none declared

Creates a new publication.

**API credit cost:** 2

## Headers

- `Authorization` string

## Request body

- PostPublicationInputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `alt` string, required: URL slug for the publication.
  - `language` string: Content language (ISO 639-1); empty = the space default.
  - `space_category_id` string, uuid, nullable: Optional category within the space.
  - `space_id` string, uuid, required: ID of the space this publication belongs to.
  - `topic_ids` string[], nullable: Optional list of topic IDs.

## Response `201`

Created

- PostPublicationOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `publication` Publication, required
    - `alt` string, required
    - `created_at` string, date-time
    - `deleted_at` string, date-time
    - `flagged_at` string, date-time
    - `id` string, uuid
    - `language` string, required
    - `metadata` Jsonb, required
    - `published_at` string, nullable, required
    - `published_draft_id` string, uuid
    - `space_category_id` string, uuid
    - `space_id` string, uuid
    - `spam_reasons` string
    - `spam_score` integer
    - `topic_ids` Jsonb
    - `update_published_at` string
    - `updated_at` string, date-time
    - `user_id` string, uuid, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/telescope/apis/telescope-api.md) - [All operations](https://skmtc.dev/telescope/apis/telescope-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telescope/apis/telescope-api/revisions/e4bd44d7f2b0?raw)