Nolt Public APIs

Welcome to the Nolt Public API documentation. This API allows you to programmatically interact with your Nolt boards, enabling you to manage posts, comments, votes, and more.

Overview

The Nolt API is based on GraphQL, providing a flexible and powerful way to interact with your Nolt data. With this API, you can:

• Retrieve posts and comments
• Create and update feedback posts
• Manage comments and votes
• Query board information
• Handle user data

Base URL

https://api.nolt.io/api/v1/graphql

Authentication

All API requests require authentication using specific headers. You can find your API key in your board settings under the "APIs" section.

Required headers:

{
  "apikey": "YOUR_API_KEY",
  "ssotype": "SSO_TYPE",
  "ssoid": "USER_SSO_ID"
}

Note: For creating a SSO user (API User), you don't need to pass ssotype and ssoid in headers.

Request Format

The API accepts GraphQL queries and mutations. All requests should be made as POST requests to the GraphQL endpoint with the appropriate headers:

Content-Type: application/json
apikey: YOUR_API_KEY
ssotype: SSO_TYPE
ssoid: USER_SSO_ID

Example Query

Here's a simple example of querying posts from your board:

query {
  posts {
    nodes {
      id
      title
      content
      votes
      author {
        name
      }
    }
  }
}

Example request using curl:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "apikey: YOUR_API_KEY" \
  -H "ssotype: SSO_TYPE" \
  -H "ssoid: USER_SSO_ID" \
  -d '{"query": "{ posts { nodes { id title content votes author { name } } } }"}' \
  https://api.nolt.io/api/v1/graphql

Rate Limits

The API implements rate limiting to ensure fair usage:

• 5 requests per second
• 60 requests per minute
• 3600 requests per hour

Getting Help

If you need help with the API:

• Check the documentation sections for specific queries and mutations
• Visit our help center
• Contact support at hello@nolt.io