Skip to main content
GET
/
v2
/
publishers
/
{publisherId}
Get Publisher
curl --request GET \
  --url https://api.tusky.io/v2/publishers/{publisherId}
{
  "id": "<string>",
  "state": "<string>",
  "epochs": 123,
  "quilt": true,
  "permanent": true,
  "share": true,
  "autoConvert": true,
  "environmentId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}
Retrieve a publisher by ID.

​
Path Parameters

​
publisherId
string
required
The unique identifier of the publisher.

​
Response

​
id
string
Unique publisher identifier.
​
state
string
Current operational state of the publisher. One of ready, idle, working, deactivated.
​
epochs
number
Default storage epoch count.
​
quilt
boolean
Whether quilt batching is enabled.
​
permanent
boolean
Whether blobs are non-deletable.
​
share
boolean
Whether blobs are shared.
​
autoConvert
boolean
Whether SUI → WAL auto-conversion is enabled.
​
environmentId
string
The environment this publisher is attached to, or null if it is the account default.
​
createdAt
string
ISO 8601 creation timestamp.
​
updatedAt
string
ISO 8601 last-updated timestamp.

​
Example

curl https://api.tusky.io/v2/publishers/pub_7f3a2b1c \
  -H "Api-Key: YOUR_API_KEY"

​
Response

{
  "id": "pub_7f3a2b1c",
  "state": "ready",
  "epochs": 5,
  "quilt": false,
  "permanent": true,
  "share": false,
  "autoConvert": true,
  "environmentId": "env_abc123",
  "createdAt": "2026-03-05T12:00:00Z",
  "updatedAt": "2026-03-05T14:30:00Z"
}