> ## Documentation Index
> Fetch the complete documentation index at: https://idle.docs.datacircle.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a download link



## OpenAPI

````yaml /openapi.json post /files/{file_id}/download-link/
openapi: 3.1.0
info:
  title: Datacircle API
  version: '1'
servers:
  - url: https://idle.api.datacircle.dev
security:
  - token: []
tags:
  - name: Datacircle
    description: 'Your Datacircle account: credits, checkout, files, invites, API key.'
  - name: iBlinked
    description: >-
      LinkedIn Profile API: iBlinked's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: iblinked`.
  - name: Up2Data
    description: >-
      LinkedIn Profile API: Up2Data's own request, sent to api.datacircle.dev
      with your Datacircle key and `X-Data-Provider: up2data`.
paths:
  /files/{file_id}/download-link/:
    post:
      tags:
        - Datacircle
      summary: Get a download link
      parameters:
        - name: file_id
          in: path
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: '`{"url": ...}`, valid one hour'
          content:
            application/json:
              schema:
                type: object
                required:
                  - allowed
                  - url
                  - next_step
                properties:
                  allowed:
                    type: boolean
                    description: '`true`: here is your link.'
                  url:
                    type: string
                    description: >-
                      A signed download URL for the file, valid one hour. Fetch
                      it as is, without your API key.
                  next_step:
                    type: object
                    required:
                      - why
                      - curls
                      - docs
                    properties:
                      why:
                        type: string
                        description: >-
                          What the file holds and what your credits can pull for
                          its rows.
                      curls:
                        type: array
                        description: >-
                          One ready-to-run call per provider. Keys never name a
                          provider: providers come and go in the list.
                        items:
                          type: object
                          required:
                            - provider
                            - curl
                          properties:
                            provider:
                              type: string
                              description: >-
                                The provider the call goes to, e.g. `iblinked`
                                or `up2data`.
                            curl:
                              type: string
                              description: A ready-to-run curl, your API key filled in.
                      docs:
                        type: string
                        description: Where Datacircle's docs are.
                    description: >-
                      What to do with the file next: pull the live LinkedIn
                      profile behind any row, at the provider's cost.
        '403':
          description: Not unlocked for this workspace
          content:
            application/json:
              schema:
                type: object
                required:
                  - allowed
                  - reason
                properties:
                  allowed:
                    type: boolean
                    description: '`false`: this workspace can''t download this file yet.'
                  reason:
                    type: string
                    description: Why, and how to unlock it.
components:
  securitySchemes:
    token:
      type: apiKey
      in: header
      name: Authorization
      description: '`Token <your API key>`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.