Skip to main content
GET
/
v2
/
documents
/
public
/
resources
/
{provider}
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/documents/public/resources/notion' \
  --header 'Authorization: Bearer fini_your_api_key'

[
  {
    "externalId": "123456",
    "title": "Billing FAQ",
    "originalUrl": "https://www.notion.so/fini/Billing-FAQ-123456",
    "mimeType": "text/markdown",
    "iconLink": null,
    "object": "page"
  },
  {
    "externalId": "789012",
    "title": "Refund Policy",
    "originalUrl": "https://www.notion.so/fini/Refund-Policy-789012",
    "mimeType": "text/markdown",
    "iconLink": "https://www.notion.so/icons/document_gray.svg",
    "object": "page"
  }
]
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

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

​
Path parameters

​
provider
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.
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/documents/public/resources/notion' \
  --header 'Authorization: Bearer fini_your_api_key'

​
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.
[
  {
    "externalId": "123456",
    "title": "Billing FAQ",
    "originalUrl": "https://www.notion.so/fini/Billing-FAQ-123456",
    "mimeType": "text/markdown",
    "iconLink": null,
    "object": "page"
  },
  {
    "externalId": "789012",
    "title": "Refund Policy",
    "originalUrl": "https://www.notion.so/fini/Refund-Policy-789012",
    "mimeType": "text/markdown",
    "iconLink": "https://www.notion.so/icons/document_gray.svg",
    "object": "page"
  }
]

​
Nested objects

​
NotionResource

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

​
ZendeskCategory

​
externalId
string
Zendesk category ID.
​
title
string
Category title.
​
type
string
Always category.
​
children
ZendeskSection[]
Nested sections inside the category.

​
ZendeskSection

​
externalId
string
Zendesk section ID.
​
title
string
Section title.
​
type
string
Always section.
​
children
ZendeskArticle[]
Nested articles inside the section.

​
ZendeskArticle

​
externalId
string
Zendesk article ID.
​
title
string
Article title.
​
originalUrl
string
Zendesk article URL.
​
type
string
Always article.

​
ConfluenceSpace

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

​
ConfluencePage

​
externalId
string
Confluence page ID.
​
title
string
Page title.
​
originalUrl
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.