SmartSpectra

Look up the caller's current SmartSpectra API key, masked. Read-only. Returns a recognizable prefix and last four characters of the active key plus the developer portal page to view it in full. The key itself is a bearer secret and is never returned here. Use api_keys.rotate to replace it.

Rotate the caller's SmartSpectra API key. Destructive and two-step: generates a new key and immediately invalidates the previous one. The first call returns status='confirmation_required' with a confirmation_token; call again with that token to execute. Any SDK clients using the old key must be updated after rotation. Returns a masked prefix and last four characters of the new key plus the developer portal page to view it in full — never the key itself.

Delete one of the caller's registered SmartSpectra applications. Destructive and two-step: the first call returns status='confirmation_required' with a confirmation_token; call again with that token to execute. Identify the application by its registration id (the 'id' from apps.list). Returns the deleted application entry.

Look up the SmartSpectra SDK configuration file for a registered application. Read-only. Only works for an application the caller has actually registered; anything else is refused. Returns the configuration file's name and MIME type plus the developer portal page to download it from, for the given platform and app_id. The file's contents are not returned: it embeds an account identifier that the SDK requires and a conversation does not.

List the caller's registered SmartSpectra applications. Read-only. Returns each registered application with its platform, app identifier, registration id, and metadata. certificate_sha is truncated to a recognizable prefix; the full value is available in the portal. Returns an empty list when no applications are registered.

Register a new SmartSpectra application or update an existing one. Two-step confirmation like other mutations: the first call returns status='confirmation_required' with a confirmation_token; call again with that token to execute. Platform-specific: for 'apple' supply org_id and omit certificate_sha; for 'android' supply certificate_sha and omit org_id. Returns the persisted application entry after verifying it.

List every SmartSpectra documentation page. Read-only. Returns the curated documentation index (title, path, one-line description, and section) for every page, so you can discover what exists and pick a path to read with docs.read. Start here when you don't already know the exact page path.

Read Presage SmartSpectra developer documentation. Read-only. Retrieves a documentation page's title, text content, section headings, and outbound links. Use this to answer questions about the SmartSpectra SDK, supported metrics, platform quickstarts, and integration details. Use docs.search or docs.map first to find the right path.

Search the SmartSpectra documentation for relevant pages. Read-only. Ranks documentation pages against your query and returns the best matches (title, path, description), most relevant first. Use the returned path with docs.read to fetch the full page. Prefer this over guessing a documentation path. If nothing matches, hits is empty and message explains that no documentation matched the query.

Look up the caller's subscription plan and remaining credits. Read-only, no arguments. Credits are tracked per account (not per registered application), so this reports the account's remaining credits, current tier, credit allowance, and next renewal date.