MossDocs API Documentation

query GetPendingReviews {
  documents(
    filter: { status: PENDING_REVIEW }
    limit: 20
  ) {
    id
    title
    status
    author {
      name
      email
    }
    createdAt
  }
}

mutation CreateFromTemplate {
  createDocument(
    title: "Weekly Status Report"
    content: "# Weekly Status\n\n## Accomplishments\n\n## Challenges\n\n## Next Week"
    folderId: "folder-id-here"
  ) {
    id
    title
    createdAt
  }
}

# Use with a loop in your application code
mutation CreateDocument($title: String!, $content: String!) {
  createDocument(
    title: $title
    content: $content
  ) {
    id
    title
  }
}

# Variables (send separately for each document):
# { "title": "Document 1", "content": "Content here..." }
# { "title": "Document 2", "content": "Content here..." }

query GetWorkspaceMembers($workspaceId: ID!) {
  workspace(id: $workspaceId) {
    id
    name
    members {
      user {
        id
        name
        email
      }
      role
      joinedAt
    }
  }
}

mutation UpdateDocument($id: ID!, $content: String!) {
  updateDocument(
    id: $id
    content: $content
  ) {
    id
    title
    content
    updatedAt
  }
}

query SearchDocuments($query: String!) {
  searchDocuments(
    query: $query
    limit: 10
  ) {
    id
    title
    excerpt
    lastModified
    author {
      name
    }
  }
}

query GetDocumentApprovalStatus($id: ID!) {
  document(id: $id) {
    id
    title
    status
    approvalWorkflow {
      status
      approvers {
        user {
          name
          email
        }
        approved
        approvedAt
      }
    }
  }
}

query GetRecentChanges {
  documents(
    filter: {
      updatedAfter: "2026-01-01"
    }
    orderBy: UPDATED_AT_DESC
    limit: 20
  ) {
    id
    title
    updatedAt
    author {
      name
    }
  }
}

mutation ArchiveDocument($id: ID!) {
  updateDocument(
    id: $id
    archived: true
  ) {
    id
    title
    archived
  }
}

query GetDocumentStats {
  workspace {
    documentCount
    documents {
      id
      title
      wordCount
      lastModified
      status
    }
  }
}

query ListTemplates {
  templates(
    category: "Sales"
    type: AI_GENERATED
  ) {
    id
    name
    description
    category
    type
    usageCount
    variables
    author {
      name
    }
  }
}

mutation CreateFromTemplate {
  createDocumentFromTemplate(
    templateId: "template-id-here"
    variables: {
      customer_name: "Acme Corp"
      date: "2024-01-15"
      project_name: "Q1 Initiative"
    }
    folderId: "folder-id-optional"
  ) {
    id
    title
    content
    createdAt
  }
}

mutation GenerateAIDocument {
  generateFromTemplate(
    templateId: "ai-template-id"
    variables: {
      customer_name: "Acme Corp"
      customer_website: "acme.com"
      call_date: "2024-02-15"
      focus_areas: "pricing, integration"
    }
  ) {
    id
    status
    templateId
    createdAt
  }
}

query GetGenerationStatus {
  generationJob(id: "job-id-here") {
    id
    status
    generatedTitle
    generatedContent
    tokensUsed
    errorMessage
    createdAt
    completedAt
  }
}

mutation AcceptGeneration {
  acceptGeneration(
    jobId: "job-id-here"
    folderId: "folder-id-optional"
  ) {
    id
    title
    content
    createdAt
  }
}

query GetTokenUsage {
  workspace {
    id
    name
    tier
    tokenUsage {
      monthlyTokensUsed
      monthlyLimit
      percentageUsed
      resetDate
    }
  }
}

mutation CreateTemplate {
  createTemplate(
    name: "Sales Call Prep"
    description: "Research template for sales calls"
    category: "Sales"
    type: AI_GENERATED
    content: "Research {{customer_name}} at {{customer_website}}..."
    variables: {
      customer_name: { type: "text", required: true }
      customer_website: { type: "text", required: true }
      call_date: { type: "date", required: false }
    }
    isPublic: false
  ) {
    id
    name
    type
    category
  }
}

1. 1.Log into MossDocs and navigate to Settings
2. 2.Go to "API Keys" section
3. 3.Click "Generate New API Key"
4. 4.Copy the key immediately (it won't be shown again)

Include your API key in the Authorization header of every request:

fetch('https://your-draft-url.com/api/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY_HERE',
  },
  body: JSON.stringify({
    query: `
      query {
        documents {
          id
          title
        }
      }
    `,
  }),
})

Test your API key with a simple query:

query TestAuth {
  me {
    id
    name
    email
  }
}

If authentication is successful, you'll receive your user information. If not, check that your API key is correct and hasn't been revoked.

query ListDocuments {
  documents(
    limit: 20
    offset: 0
    folderId: null  # Optional: filter by folder
  ) {
    id
    title
    content
    isPublic
    isArchived
    createdAt
    updatedAt
    folder {
      id
      name
    }
  }
}

query GetDocument {
  document(id: "cm4abc123def") {
    id
    title
    content
    isPublic
    createdAt
    updatedAt
    author {
      id
      name
      email
    }
    versions {
      id
      commitHash
      message
      createdAt
    }
  }
}

mutation CreateDocument {
  createDocument(
    title: "Getting Started Guide"
    content: "# Welcome\n\nThis is my new document!"
    folderId: null  # Optional: place in a folder
  ) {
    id
    title
    content
    createdAt
    author {
      name
    }
  }
}

mutation UpdateDocument {
  updateDocument(
    id: "cm4abc123def"
    title: "Updated Title"
    content: "# Updated Content\n\nNew information here."
  ) {
    id
    title
    content
    updatedAt
  }
}

mutation DeleteDocument {
  deleteDocument(id: "cm4abc123def") {
    id
    title
  }
}

query GetVersionHistory {
  document(id: "cm4abc123def") {
    id
    title
    versions {
      id
      commitHash
      message
      createdAt
      author {
        name
      }
    }
  }
}