---
title: "A nyilvános REST API | Posty dokumentáció"
description: "Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás."
canonical: https://posty.hu/en/docs/api
source: https://posty.hu/en/docs/api.md
---

Nyilvános API

# A nyilvános REST API

Alapcím, első hívás, a kérés és a válasz alakja, és hol van a gépi leírás.

## The basics

Base URL

`https://api.posty.hu/public/v1`

Version

In the path: /public/v1

Authentication

API key as the entire `Authorization` header, or an OAuth 2.1 access token

Format

Every request and response is JSON

Dates

ISO 8601, always UTC

OpenAPI 3

[https://posty.hu/openapi.json](https://posty.hu/openapi.json)

Availability

Available on the Pro plan and above. See the [Plans](https://posty.hu/en/docs/plans) page.

## The first call

`/status` is the only path that responds without a key. That's the fastest way to check you can reach us, and it gives you the URL of every other document:

```
curl https://api.posty.hu/public/v1/status
```

Kód másolása

The first authenticated call lists your channels:

```
curl https://api.posty.hu/public/v1/integrations \
  -H "Authorization: psty_a_kulcsod"
```

Kód másolása

No Bearer prefix in front of the API key

The API key is the `Authorization` header's **entire** value, with no `Bearer`. The `Bearer` prefix belongs to the OAuth token. That's the most common reason a first call gets a 401.

You create the key yourself in Posty. See the [Authentication](https://posty.hu/en/docs/api/authentication) page.

## What v1 can do

The API manages the same workspace as the web interface. The one thing it cannot do is connect a channel, because the platform asks a person to do that.

[Channels — Listing, settings schemas, platform-specific queries.](https://posty.hu/en/docs/api/endpoints/csatornak)[Posts — Create, schedule, publish immediately, calendar, delete.](https://posty.hu/en/docs/api/endpoints/bejegyzes-letrehozas)[Media — Upload from a file or a public URL.](https://posty.hu/en/docs/api/endpoints/media-feltoltes)[Analytics — Channel and post statistics.](https://posty.hu/en/docs/api/endpoints/csatorna-statisztika)

You'll find the full list on the [Endpoints](https://posty.hu/en/docs/api/endpoints) page, with a separate page for each endpoint.

## Request and response shape

Every body is JSON, and every date is ISO 8601 UTC. Errors are JSON too. The [Errors and limits](https://posty.hu/en/docs/api/errors) page describes their shape and the rate limits.

If a key belongs to more than one workspace, the `showorg` header selects which one the call applies to.

## Machine-readable description

OpenAPI 3

[https://posty.hu/openapi.json](https://posty.hu/openapi.json)

MCP manifest

[https://posty.hu/.well-known/mcp.json](https://posty.hu/.well-known/mcp.json)

Summary for agents

[https://posty.hu/llms.txt](https://posty.hu/llms.txt)

OAuth metadata

`https://api.posty.hu/.well-known/oauth-protected-resource`

This page in Markdown

[https://posty.hu/dokumentacio/api.md](https://posty.hu/dokumentacio/api.md)

You can generate client code from the OpenAPI document, and every scope name is in it under `components.securitySchemes`.

## What's next

[Authentication — Keys, scopes, choosing a workspace.](https://posty.hu/en/docs/api/authentication)[Errors and limits — Error shapes, retries, RateLimit headers, versioning.](https://posty.hu/en/docs/api/errors)[OAuth 2.1 — If you want to manage other people's accounts from your own app.](https://posty.hu/en/docs/api/oauth)[Webhooks — The reverse direction: we notify your system.](https://posty.hu/en/docs/automation/webhooks)

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.