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"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.usefini.com/llms.txt

Use this file to discover all available pages before exploring further.

Lists resources that can be imported from a connected provider. This is the first call in the provider import flow — once you’ve picked the resources you want, pass them to Register provider resources to create Fini document 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’s already in Fini. To see what’s already imported, use List documents 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 resource objects.
​
[]
array
Array of importable Notion resources.

​
Zendesk

A nested category tree. Categories contain section children, and sections contain article children.

​
Confluence

An array of spaces, each with nested pages. 
[
  {
    "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"
  }
]

​
Next step

Once you’ve picked the resources to import, pass them to Register provider resources to create Fini document records. Resource registration alone does not queue ingestion — you’ll need to call Queue ingestion 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 documents with source set to the provider to see what’s in Fini already.