Your own Voice

Read source posts used for analysis

Use this endpoint from your own integration, with the same account permissions and safeguards as the app.

Scope · voice:read

Request

GET/api/v1/voice/{accountId}/versions/{profileId}/sources

Example requestcURL

curl 'https://postlift.io/api/v1/voice/{accountId}/versions/{profileId}/sources' \
  -H "Authorization: Bearer $POSTLIFT_API_KEY"

Replace path placeholders with your Postlift resource IDs. Example timestamps must be replaced with a future time; preserve the same timestamp when retrying the same operation.

Parameters

Name	Location	Description
`accountId`required	path	Postlift resource ID belonging to the API key owner.
`profileId`required	path	Postlift resource ID belonging to the API key owner.

Response

200 Successful operation.

Field Type & constraints

postsrequired

object[]

Nested fields ↓

Field	Type & constraints
`id`required	string
`text`required	string
`createdAt`required	string
`lang`required	string
`reply`required	boolean \| null
`truncated`required	boolean

Explore Sources ↗

View JSON schema

{
  "type": "object",
  "properties": {
    "posts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "lang": {
            "type": "string"
          },
          "reply": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "text",
          "createdAt",
          "lang",
          "reply",
          "truncated"
        ],
        "additionalProperties": true
      }
    }
  },
  "required": [
    "posts"
  ],
  "additionalProperties": true
}

Errors & retries

Failures use a stable error code and request ID. Check the current resource version or request status before retrying a write.

Status	Meaning
`400`	Invalid input or Jev rejection
`401`	Invalid, expired or revoked API key
`402`	Plan, publishing quota or AI credit requirement
`403`	Missing scope
`404`	Resource not found or not owned
`409`	Version conflict, missing voice or duplicate AI operation
`413`	Payload too large
`429`	Rate or concurrency limit
`500`	Internal error
`502`	Upstream failure; inspect operation status
`503`	Service or review unavailable

Read the retry guide ↗