Expanded Limits, Across all tiers - Our Gift to you! Learn more →

AlterLab
SearchResearchPricingComparePlaygroundBlogDocsChangelog
    AlterLabAlterLab
    PricingComparePlaygroundBlogDocsChangelog
    IntroductionQuickstartInstallationYour First Request
    REST APICrawl APIMap APISearch APIResearch APINewSERP APINewExtract APIAIJob PollingDomain StatsNewGeocode APINewNews APIBatch ResultsNewAPI KeysSessions APINewEnterprise APIEnterprise
    AccountAutoAI VisibilityAutoAlertsAutoAuthAutoBillingAutoCrawlAutoExtractAutoIntegrationsAutoKeysAutoMapAutoMonitorsAutoOrganizationsAutoResearch SchedulesAutoRunsAutoSchedulesAutoScrapeAutoSearchAutoSearch SchedulesAutoSessionsAutoUser WebhooksAutoV1 EndpointsAutoAffiliatesAutoAgentAutoAgent OnboardingAutoAgent VisibilityAutoAnalyticsAutoApprovalsAutoArtifactsAutoAttributionAutoB2BAutoBatchAutoBeta FeaturesAutoBlogAutoBuyerAutoChatAutoConnectionsAutoConnectorsAutoContact ListsAutoCreatorAutoCross SellAutoDashboardAutoDefaultsAutoDomainsAutoEmail PreferencesAutoFcAutoHandsAutoHealthAutoJobsAutoListingsAutoMaintenanceAutoNewsAutoOauthAutoOauth GrantsAutoPage InspectAutoPlatformAutoPresetsAutoPricingAutoPrivacyAutoPublicAutoPublic PagesAutoReferralAutoReferralsAutoReportsAutoResearchAutoSecretsAutoSerpAutoSSOAutoStorefrontsAutoSupportAutoTemplatesAutoToolsAutoTrackAutoUsageAutoUsage TagsAutoUserAutoWorkflowsAutoWorkspacesAutoWebhooksAuto
    OverviewPythonNode.jsCLI
    Guides OverviewJavaScript RenderingBrowser ActionsOutput FormatsPDF & OCRCachingWebhooksJSON Schema FilteringWebSocket Real-TimeBring Your Own ProxyProSticky SessionsProAuthenticated ScrapingNewHTTP Methods & BodiesNewStructured ExtractionAIWeb SearchAgent and RAG GroundingResearch JobsAgent RunsSite MappingWeb CrawlingBatch ScrapingSchedulerData MarketplaceSelling DataAgent OnboardingEmbeddingsKeyword IdeasAI VisibilityWorkflowsChange DetectionCloud Storage ExportSpend LimitsOrganizations & TeamsScrape TemplatesCustom ConnectorsSecretsContact ListsPlatform Sub-AccountsReferrals & AffiliatesAlerts & NotificationsExtraction ProfilesAIBYOK ExtractionAIOAuth2 Machine-to-MachineSupport & TicketsUnsupported Targets
    Tutorials OverviewStructured ExtractionAIE-commerce ScrapingNews MonitoringPrice MonitoringMulti-Page CrawlingMonitoring DashboardAI Agent / MCPMCPAI Research AgentAISite CrawlingData Pipeline to Cloud
    E-commerceLead GenerationChange MonitoringRAG & AI PipelinesAIResearch
    Reference OverviewPricingRate LimitsReliabilityReliability ContractError CodesChangelogVersioning
    Migrations OverviewFrom FirecrawlFrom ApifyFrom ScrapingBee / ScraperAPIFrom Crawl4AIFrom SpiderSearch to SERPFirecrawl v0 API ReferenceLegacy
    OverviewMCP ServerAIn8n NodeLangChainAICrewAIAILlamaIndexAISupabaseChrome ExtensionSoon
    PlaygroundPricingStatus

    Up to 5,000 free requests · No credit card

    Guide

    Secrets

    Store credentials once and reference them by name from workflows. Values are never returned by the API.

    Beta

    The secrets endpoints are part of the workflow-studio beta and require that beta feature to be enabled on the account.

    Create a Secret

    POST /api/v1/secrets takes name and value (required), plus optional integration, kind and allowed_domains.

    Bash
    curl -X POST https://api.alterlab.io/api/v1/secrets   -H "X-API-Key: $ALTERLAB_API_KEY" -H "Content-Type: application/json"   -d '{"name": "crm-token", "value": "REDACTED", "allowed_domains": ["api.example.com"]}'

    List Secrets

    GET /api/v1/secrets lists secrets with a masked preview. Filter with the integration query parameter.

    Bash
    curl "https://api.alterlab.io/api/v1/secrets?integration=hubspot"   -H "X-API-Key: $ALTERLAB_API_KEY"

    Get a Secret

    GET /api/v1/secrets/{secret_id} returns metadata and a masked preview, never the stored value.

    Bash
    curl https://api.alterlab.io/api/v1/secrets/SECRET_ID   -H "X-API-Key: $ALTERLAB_API_KEY"

    Rotate a Secret

    PUT /api/v1/secrets/{secret_id} with a new value replaces the stored value.

    Bash
    curl -X PUT https://api.alterlab.io/api/v1/secrets/SECRET_ID   -H "X-API-Key: $ALTERLAB_API_KEY" -H "Content-Type: application/json"   -d '{"value": "NEW_VALUE"}'

    Delete a Secret

    DELETE /api/v1/secrets/{secret_id} removes the secret and returns 204.

    Bash
    curl -X DELETE https://api.alterlab.io/api/v1/secrets/SECRET_ID   -H "X-API-Key: $ALTERLAB_API_KEY"

    Share With a Workspace

    Share a secret to an organization workspace through the workspace share endpoint with resource type secret. Teammates see a masked preview only. See the Organizations guide.

    Custom ConnectorsContact Lists
    Last updated: June 2026

    On this page