featurejet 0.2.0

Official Python SDK for the FeatureJet public developer API.

FeatureJet Python SDK

Official synchronous Python client for the FeatureJet public developer API.

Install

pip install featurejet

Quickstart

API keys are minted in the FeatureJet dashboard and begin with fj_live_. The SDK sends the key as an Authorization: Bearer header.

from featurejet import (
    ApiPostCreateRequest,
    FeatureJetClient,
    FeatureJetClientConfig,
)

with FeatureJetClient(
    FeatureJetClientConfig(api_key="fj_live_REPLACE_ME"),
) as client:
    posts = client.list_posts("feedback", limit=25, offset=0)
    for post in posts.posts:
        print(post.title, post.vote_count)

    created = client.create_post(
        "feedback",
        ApiPostCreateRequest(
            title="Dark mode",
            body="Please add a system theme",
            tags=["UI"],
        ),
    )
    print(created.id)

The default base URL is https://api.featurejet.com. Configure a different host by passing base_url to FeatureJetClientConfig.

Endpoints

API endpoint	SDK method
GET /api/v1/boards	list_boards()
GET /api/v1/boards/{slug}	get_board(slug)
GET /api/v1/boards/{slug}/posts	list_posts(slug, ...)
POST /api/v1/boards/{slug}/posts	create_post(slug, request)
GET /api/v1/boards/{slug}/posts/{id}	get_post(slug, post_id)
PATCH /api/v1/boards/{slug}/posts/{id}	update_post(slug, post_id, request)
DELETE /api/v1/boards/{slug}/posts/{id}	delete_post(slug, post_id)
GET /api/v1/boards/{slug}/posts/{id}/votes	list_votes(slug, post_id)
GET /api/v1/boards/{slug}/posts/{id}/comments	list_comments(slug, post_id)
GET /api/v1/boards/{slug}/roadmap	get_roadmap(slug)
GET /api/v1/boards/{slug}/changelog	get_changelog(slug, ...)
GET /api/v1/boards/{slug}/ship-stats	get_ship_stats(slug, ...)
GET /api/v1/boards/{slug}/analytics	get_analytics(slug, ...)

Pagination is explicit: list_posts and get_changelog accept limit and offset. The API defaults to 100 results and permits at most 500.

Errors and rate limits

API error envelopes raise FeatureJetApiError. HTTP 429 responses raise the FeatureJetRateLimitError subclass; its retry_after attribute contains the integer Retry-After value when the response includes one. The public API is limited to 120 requests per minute per API key. The SDK does not retry requests automatically.