Files

Create a file preview URL

Mints a preview URL that redirects to a short-lived signed GET so the browser can open a file stored with POST /api/v1/files. The preview URL stays valid until expiresAt. Do not pass it to LinkedIn.

POST

/api/v1/files/access

Request bodyrequired

urlrequired

string · uri

Response

200A preview URL and when it stops redirecting. Each visit gets a fresh signature.

downloadUrl

string

Preview URL on needle.app that redirects to a short-lived signed GET. Do not send this to LinkedIn.

expiresAt

string · date-time

When the preview URL stops redirecting. Each visit mints a fresh signature until then.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy