GET
/
v1
/
teams
/
{teamId}
/
posts
/
{postId}
/
raw-provider-errors
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.social.listPostRawProviderErrors({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  postId: process.env.OCTOSPARK_POST_ID ?? "postId",
})
[
  {
    "scheduledPostId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "socialAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "rawProviderError": {
      "provider": "<string>",
      "operation": "<string>",
      "endpoint": "<string>",
      "httpStatus": 123,
      "providerCode": "<string>",
      "providerSubcode": "<string>",
      "providerType": "<string>",
      "rawMessage": "<string>",
      "rawBody": "<string>",
      "bodyTruncated": true,
      "requestId": "<string>",
      "traceHeaders": {},
      "occurredAt": "<string>",
      "attemptNumber": 123,
      "translatedMessage": "<string>"
    }
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

postId
string
required

Post id (UUID), as returned by the create post and list posts endpoints.

Response

Success

scheduledPostId
string<uuid>
required

The scheduled post leg (one per target account) the failed external call belongs to.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
socialAccountId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
provider
enum<string>
required

Social platform identifier: x, tiktok, instagram, facebook, youtube, linkedin, threads, or pinterest.

Available options:
x,
tiktok,
instagram,
facebook,
youtube,
linkedin,
threads,
pinterest
Example:

"x"

rawProviderError
object
required

The provider's own error: HTTP status, provider code/subcode/type, raw message and body (secrets redacted, truncated to 16 KB), request id and trace headers, endpoint without secrets, timestamp and attempt number.