Refresh a library

Trigger a refresh of an existing library to fetch the latest documentation. Library owners have dedicated refresh limits.

POST /v1/refresh

cURL

github

curl --request POST \
  --url https://context7.com/api/v1/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "libraryName": "/vercel/next.js"
}
'

200

Example

{
  "message": "Refresh started successfully"
}

Authorizations

Authorization · string · header · required

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Body

application/json

libraryName · string · required

Library identifier — the URL path of the library on context7.com. Use /owner/repo for GitHub repositories (e.g., /vercel/next.js), or /<source>/<id> for other sources (e.g., /websites/uploadcare_com, /llmstxt/<source>). See Library ID format.

branch · string

Optional branch name to refresh

gitToken · string

Optional Git access token for refreshing private repositories. If not provided, the stored OAuth token will be used.

Response

200

application/json

Refresh started successfully

message · string · required