Skip to main content
GET
Lists resources that can be imported from a connected provider. This is the first call in the connected-source flow. Once you have picked the resources you want, pass them to Register provider resources to create source records.
Resources that have already been imported successfully from the provider are excluded from the response. This endpoint is for discovering new content, not auditing what is already in Fini. To see what is already imported, use List sources with the provider as a source filter.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_...

Path parameters

string
required
Provider name. Supported values: notion, zendesk, confluence.
The provider must already be connected in the workspace via the dashboard. A disconnected or unsupported provider returns 400 Bad Request.

Response

The response shape varies by provider.

Notion

A flat array of NotionResource objects.
NotionResource[]
Array of importable Notion resources.

Zendesk

A nested category tree returned as ZendeskCategory[]. Categories contain section children, and sections contain article children.
ZendeskCategory[]
Root category tree for the connected Zendesk help center.

Confluence

An array of ConfluenceSpace objects, each with nested pages.
ConfluenceSpace[]
Array of importable Confluence spaces.

Nested objects

NotionResource

string
Notion page or database ID.
string
Resource title.
string
Notion URL.
string
MIME type. Typically text/markdown for pages.
URL to the resource’s Notion icon, when set.
string
Notion object type, for example page or database.

ZendeskCategory

string
Zendesk category ID.
string
Category title.
string
Always category.
ZendeskSection[]
Nested sections inside the category.

ZendeskSection

string
Zendesk section ID.
string
Section title.
string
Always section.
ZendeskArticle[]
Nested articles inside the section.

ZendeskArticle

string
Zendesk article ID.
string
Article title.
string
Zendesk article URL.
string
Always article.

ConfluenceSpace

string
Confluence space key.
string
Space title.
string
Space URL.
ConfluencePage[]
Pages discovered inside the space.

ConfluencePage

string
Confluence page ID.
string
Page title.
string
Page URL.

Next step

Once you’ve picked the resources to import, pass them to Register provider resources to create source records. Resource registration alone does not queue ingestion. You still need to call Ingest sources after.

Errors

The provider is not supported on the public route (only notion, zendesk, confluence are accepted), or it’s not connected in the workspace yet. Connect the provider in the dashboard first.
The API key is missing, malformed, revoked, or invalid. Confirm Authorization: Bearer fini_... with the full key.
The API key doesn’t include the read scope, or the provider connection belongs to a different workspace.
Either the provider has no content to import, or everything available has already been imported. Already-imported resources are filtered out. Check List sources with source set to the provider to see what is already in Fini.