Skip to content
Sursa Developers

API reference

The public Sursa API: 222 endpoints in 35 sections. Version 1.62.0.

The public Sursa API for integrations that authenticate with an API key. Changes within /v1 are additive: new operations, optional parameters, response fields and response enum values can appear, and existing clients keep working. Treat unknown enum values in responses as valid.

Base URL
https://api.sursa.com
Authentication
Send an API key in the Authorization header: Authorization: Bearer <key>.

Sections

health1 endpoint

Service status and version

auth1 endpoint

Sign-in, sessions, “View as” mode, password change and reset, accepting invitations

users5 endpoints

User accounts of the organization

api-keys9 endpoints

API keys of the organization

apps8 endpoints

OAuth apps of the organization and employee authorizations

oauth3 endpoints

The OAuth 2.0 protocol: consent screen, token issuance and revocation, authorization server metadata

audit4 endpoints

Audit log of the organization

org1 endpoint

The organization, its logo and data export

categories4 endpoints

Document categories

collections6 endpoints

Knowledge collections

cards26 endpoints

Knowledge cards: upload, content, tables, versions, verification, comments

jobs5 endpoints

Indexing queue: jobs, parse preview, change stream (SSE)

conversations2 endpoints

Conversations with the assistant

answers3 endpoints

Search and assistant answers, including the SSE stream

access-requests4 endpoints

Requests for access to the sources of a hidden answer

questions10 endpoints

Question log, suggestions, answer exports, live answer

files8 endpoints

Export files

insights1 endpoint

Insights: summary, duplicates, knowledge gaps and knowledge health

tasks1 endpoint

Tasks of a user and of a team

sources19 endpoints

Data sources, such as Google Drive and Confluence

permissions17 endpoints

Access model: the permission registry and permissions on the organization, collections, cards and sources, both granted directly and inherited

roles4 endpoints

Roles: named sets of permissions, built-in and custom

groups7 endpoints

User groups: regular groups, “All members”, role groups and personal groups

folders7 endpoints

Collection folders: a tree up to three levels deep, ordering relative to a sibling, one card in several folders, inherited permissions

catalog6 endpoints

Catalog of external services (SaaS and vendors) with names, websites, categories, icons and descriptions, and links between your organization's names and catalog entries

drafts6 endpoints

Drafts and publication approval

verification9 endpoints

Verification: status, due dates, verifiers, history, the “verify first” queue, Trust Score and offboarding

announcements5 endpoints

Must-read announcements: audience, read confirmation, reports, reminders, export

comments4 endpoints

Threaded card comments with an anchor and a status, and reactions

webhooks17 endpoints

Organization webhooks: endpoints, event subscriptions, signatures, deliveries and retries

public-api1 endpoint

Public API for integrations: the machine-readable specification of this API

uploads5 endpoints

Multipart uploads of large files: the session, the parts, completion with checks, and use by a card, an archive or an import

analytics4 endpoints

Product analytics: usage events, per-object counters, the health, usage and contribution dashboards, the renewal report and exports

quality3 endpoints

Answer quality: questions without a good answer and the knowledge gaps taken into work

finance6 endpoints

Financial documents: exchange rates and the counterparty directory

Objects