GraphQL API beta reference

Use GraphQL for the supported core operations

POST https://api.krevaya.com/graphql accepts query, optional variables, and optional operationName. The beta exposes me, posts, and createPost. It uses the same API keys, scopes, plan check, safety checks, and account request budget as REST. Media upload, Canvas editing, webhooks, and job polling use their documented REST or MCP interfaces.

Query account details and drafts

curl --fail-with-body https://api.krevaya.com/graphql \
  -H "Authorization: Bearer $KREVAYA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"query":"query { me { plan scopes } posts(status: \"draft\", limit: 5) { id platform status body scheduledFor mediaCount } }"}'

posts defaults to drafts with limit 25, clamped to 1–100. Pass brandId as a GraphQL ID string for an explicit brand. Omitting it follows the dashboard's selected brand. Use GraphQL variables for dynamic content rather than interpolating values into the query string.

Create a draft with variables

{
  "query": "mutation CreateDraft($input: CreatePostInput!) { createPost(input: $input) { id platform kind status scheduledAt } }",
  "variables": {
    "input": {
      "platform": "linkedin",
      "body": "We now record the reported symptom before starting a repair estimate.",
      "brandId": "YOUR_BRAND_ID"
    }
  },
  "operationName": "CreateDraft"
}

CreatePostInput requires platform and body. Optional fields are hashtags, scheduleAt, kind, assetIds, and brandId. The mutation requires publish. Omit scheduleAt to create a draft; a future ISO-8601 value schedules it directly. The result exposes id, platform, kind, status, and scheduledAt. The beta input does not include native layout, template, or design_id.

Use the documented schema

type Query {
  me: Me!
  posts(status: String, limit: Int, brandId: ID): [Post!]!
}

type Mutation {
  createPost(input: CreatePostInput!): CreatePostResult!
}

input CreatePostInput {
  platform: String!
  body: String!
  hashtags: String
  scheduleAt: String
  kind: String
  assetIds: [ID!]
  brandId: ID
}

IDs are GraphQL ID values serialized as strings, not GraphQL Int. Schema introspection is disabled. A query string is limited to 2,000 characters, with at most eight root query fields, one root mutation field, and 60 selected fields.

Check errors even when HTTP status is 200

Syntax, schema validation, and breadth-limit failures return HTTP 400 with data: null and errors. Authentication and account throttling can fail before execution. Resolver execution errors, including a missing scope or invalid createPost input, can return HTTP 200 with errors. Read both response.ok and the errors array before using data.

const payload = await response.json();
if (!response.ok || payload.errors?.length) {
  throw new Error(JSON.stringify(payload.errors ?? payload));
}
const drafts = payload.data.posts;

Frequently asked questions