# Blackpearl Developer Documentation > Build a production-grade Blackpearl Playbooks or Audiences integration from canonical public Markdown and OpenAPI. ## Start here - [Playbooks API primer](https://engine.neraperla.com/docs/raw/playbooks-api-primer.md): Minimal complete context for an agent implementing the golden flow. - [OpenAPI contract](https://engine.neraperla.com/v1/openapi.json): Exact paths, schemas, authentication, enums, defaults, and errors. - [API changelog](https://engine.neraperla.com/docs/api-changelog.md): Observable public contract and behavior changes. - [Full documentation bundle](https://engine.neraperla.com/llms-full.txt): All public guides in deterministic order. - [Documentation MCP server](https://engine.neraperla.com/docs/mcp/): Read-only search and canonical page retrieval. ## Guides - [Quickstart](https://engine.neraperla.com/docs/raw/getting-started.md): Create your first job, poll it safely, and print a useful sales result. - [Build a GTM workflow](https://engine.neraperla.com/docs/raw/gtm-workflow.md): Chain the main capabilities — brand and offer context, prospecting, playbooks, and outcomes — into one attributable end-to-end workflow. - [Brands](https://engine.neraperla.com/docs/raw/brands.md): Turn a company name or website into a versioned, evidence-backed brand guideline. - [Offers](https://engine.neraperla.com/docs/raw/offers.md): Reuse structured value propositions, proof points, pricing shape, ICP hints, and deal-stage fit across GTM work. - [Campaigns](https://engine.neraperla.com/docs/raw/campaigns.md): Save repeatable targeting, bind GTM context, and run asynchronous audience cycles without granting delivery authority. - [Audiences](https://engine.neraperla.com/docs/raw/audiences.md): Run evidence-backed audience discovery, then materialize immutable review snapshots from real prospects. - [Playbooks](https://engine.neraperla.com/docs/raw/playbooks.md): Configure a Playbooks request and interpret every part of its typed result. - [Playbooks integration kit](https://engine.neraperla.com/docs/raw/integration-kit.md): Run the standalone reference product or import an OpenAPI-derived request collection. - [Documents](https://engine.neraperla.com/docs/raw/documents.md): Turn a brief, Brand Pack, and optional Offer into downloadable PPTX, DOCX, or PDF files. - [Message Templates](https://engine.neraperla.com/docs/raw/message-templates.md): Turn approved GTM context and prospect evidence into quality-gated, approval-only outreach copy. - [Prospecting](https://engine.neraperla.com/docs/raw/prospecting.md): Run prospect discovery with the prospect agent and poll the append-only live event thread. - [Prospecting extensions](https://engine.neraperla.com/docs/raw/prospecting-extensions.md): Explore bounded continuation Jobs and immutable qualification rubrics without treating either contract as GA. - [Infinite Intent](https://engine.neraperla.com/docs/raw/infinite-intent.md): Run an intent-driven audience programme, follow the run's progress and open the interactive results page in your browser. - [Prospect Research](https://engine.neraperla.com/docs/raw/prospect-research.md): Retrieve structured company intelligence, analyze an unindexed website, and optionally add lookalikes. - [Professional Network](https://engine.neraperla.com/docs/raw/professional-network.md): Bind reviewed Audience members to an official Sales Navigator connection contract without scraping or execution. - [Account Coordination](https://engine.neraperla.com/docs/raw/account-coordination.md): Derive an immutable account-level preflight from a reviewed Audience and its Outcome evidence. - [Enrichment](https://engine.neraperla.com/docs/raw/enrichment.md): Fill contact and company fields from the platform's data — post identifiers you hold, synchronously or as a batch of up to 1,000. - [Data Intake](https://engine.neraperla.com/docs/raw/data-intake.md): Store immutable source, selection, field, deduplication, purpose, and retention contracts without executing intake. - [Site Intelligence](https://engine.neraperla.com/docs/raw/site-intelligence.md): Run bounded, robots-respecting website crawls distilled into typed company intelligence, and store contract-only site-audit plans. - [Feedback and outcomes](https://engine.neraperla.com/docs/raw/outcomes.md): Append external prospect, account, or campaign results and aggregate them across the GTM graph. - [Authentication and project environments](https://engine.neraperla.com/docs/raw/authentication.md): Protect project and company-level Bearer keys and isolate environments or clients in projects. - [Jobs and resumable polling](https://engine.neraperla.com/docs/raw/jobs.md): Persist asynchronous job IDs, poll with bounded backoff, and stop on every terminal status. - [Errors and retry decisions](https://engine.neraperla.com/docs/raw/errors.md): Branch on stable error codes and retry only operations that are safe and transient. - [Rate limits](https://engine.neraperla.com/docs/raw/rate-limits.md): Recover from transient request-rate limits without confusing them with quota or budget exhaustion. - [Limits, budgets, and usage](https://engine.neraperla.com/docs/raw/usage-quotas.md): Distinguish request rate, monthly quota, hard budget, credits, and Usage API counters. - [Billing and auto-recharge](https://engine.neraperla.com/docs/raw/billing.md): How prepaid credit is charged, how to cap spend, and how to keep the balance topped up automatically. - [Managing your clients with projects](https://engine.neraperla.com/docs/raw/projects.md): Run one project per client with a company-level key, give each an allowance, daily and monthly limits and its own brand, top it up or reduce it, and read what it was charged. - [Troubleshooting and request diagnostics](https://engine.neraperla.com/docs/raw/troubleshooting.md): Correlate a failed call, inspect organization request records, and prepare a support-safe diagnostic package. - [Connections](https://engine.neraperla.com/docs/raw/connectors.md): Read the provider catalog and redacted project connection metadata while live connector operations remain unavailable. - [Inspect the CRM schema preview boundary](https://engine.neraperla.com/docs/raw/crm-schema.md): Understand the Console-only HubSpot and Salesforce metadata snapshot contract and its fail-closed service boundary. - [Capabilities and entitlements](https://engine.neraperla.com/docs/raw/feature-flags.md): Discover which capability keys the authenticated organization can use before creating work. - [Agent connection procedure](https://engine.neraperla.com/docs/raw/agent-setup.md): Approve one browser request to connect your current AI session, verify access and credits, and start working. - [Set up your AI agent](https://engine.neraperla.com/docs/raw/agent-resources.md): Copy the prompt, paste it into your AI chat, and approve access. Your agent handles the connection. - [Optional agent integrations](https://engine.neraperla.com/docs/raw/agent-integrations.md): Configure an OAuth connector, documentation tools, or a saved skill when you specifically need one. - [Playbooks API primer for agents](https://engine.neraperla.com/docs/raw/playbooks-api-primer.md): Give a coding agent the minimum complete contract for creating, polling, and consuming a Playbooks job safely. - [Roles and console access](https://engine.neraperla.com/docs/raw/rbac.md): See what each console role can do, and how API keys are authorized separately from roles. - [Workbench guide](https://engine.neraperla.com/docs/raw/workbench.md): Run any enabled capability interactively in the console, inspect jobs and usage, then copy the exact API request for automation. - [Security and data handling](https://engine.neraperla.com/docs/raw/security-data.md): Review credential boundaries, project isolation, capability data flow, retention, and logging behavior. - [API compatibility and deprecation](https://engine.neraperla.com/docs/raw/versioning.md): Build tolerant v1 clients and understand additive changes, previews, deprecation notices, and support windows.