Knowledge
List provider resources
Discover importable resources from a connected provider. Step 1 of the provider import flow.
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.Response
The response shape varies by provider.Notion
A flat array ofNotionResource objects.
NotionResource[]
Array of importable Notion resources.
Zendesk
A nested category tree returned asZendeskCategory[]. Categories contain section children, and sections contain article children.
ZendeskCategory[]
Root category tree for the connected Zendesk help center.
Confluence
An array ofConfluenceSpace 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.string | null
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
400 Bad Request
400 Bad Request
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.403 Forbidden
403 Forbidden
The API key doesn’t include the
read scope, or the provider connection belongs to a different workspace.The response is empty
The response is empty
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.
