> ## Documentation index > Fetch the complete documentation index at: https://context7.com/docs/llms.txt > Ask it with GET https://context7.com/docs/ask?q=. Short keywords rank best. > Use these to discover all available pages before exploring further. > Feature requests: https://context7.com/docs/resources/feature-requests.md lists what users asked for and how to vote for a request or add one. > Page rating: `GET https://context7.com/docs/feedback?path=/docs/api-reference/teamspace-libraries/refresh-a-library&helpful=true` (or `false`) records whether this page helped. An optional `comment` (URL-encoded, at most 500 characters) says what was missing or wrong. It is anonymous and needs no key. Comments hold no code, secrets or personal data. # Refresh a library > Parse the library (or one branch) again from its source. Works for the teamspace's private and claimed libraries, and for any public library. Owners can refresh a limited number of times per period. Uploaded files cannot be refreshed. `POST /v2/teamspaces/{teamspaceId}/libraries/{owner}/{repo}/refresh` ## OpenAPI ````yaml https://context7.com/openapi.json post /v2/teamspaces/{teamspaceId}/libraries/{owner}/{repo}/refresh openapi: 3.0.0 info: title: Context7 Public API description: The Context7 Public API provides programmatic access to library documentation and search functionality. Get up-to-date documentation and code examples for any library. version: 2.0.0 contact: name: Context7 Support url: https://context7.com email: support@context7.com servers: - url: https://context7.com/api description: Production server tags: - name: Search description: Search for libraries in the Context7 database - name: Context description: Retrieve documentation context for queries - name: Ask description: Answer questions from a website registered with Context7 Ask - name: Refresh description: Refresh existing libraries to fetch latest documentation - name: Policies description: Manage teamspace access policies and filters - name: Add Library description: Submit new libraries for documentation processing - name: Metrics description: Retrieve usage metrics for libraries - name: Usage description: See member and teamspace API usage - name: Teamspaces description: Teamspaces the caller is a member of. The management API (`/v2/teamspaces/*`) accepts a Context7 API key created with management access (other keys get 403 `management_access_required`), which reaches only its own teamspace, or an OAuth token issued for the Context7 Admin MCP server (`https://admin.mcp.context7.com/mcp`), which reaches every teamspace of the user. A browser session is not accepted. - name: Teamspace Admin description: Members, invitations, rules, library policies and requests, usage and the spending limit of a teamspace. - name: Teamspace Libraries description: "A teamspace's libraries: its private sources and the libraries it has claimed. Add, refresh, configure, version, claim and remove them, and read their parse state and usage. A library id `/owner/repo` is two path segments." - name: Docs7 Sites description: 'Docs7 documentation sites of a teamspace: settings, custom domains, deployments, previews and the Docs7 agents. Any member can read; owners and admins can change; developers can add a site, publish one added for the agents only, and rebuild. Sites deployed with the `docs7 deploy` CLI have `source: "local"`; operations marked GitHub-only answer 404 for them.' - name: Docs7 Analytics description: "Traffic of one Docs7 site: visitors, AI crawlers, searches, assistant questions and page feedback. Docs7 Free reads the last 7 days, Docs7 Pro the last 90." - name: Ask Sites description: "Manage a teamspace's Context7 Ask sites: add, verify, remove, and read their analytics and question log" paths: /v2/teamspaces/{teamspaceId}/libraries/{owner}/{repo}/refresh: post: tags: - Teamspace Libraries summary: Refresh a library description: Parse the library (or one branch) again from its source. Works for the teamspace's private and claimed libraries, and for any public library. Owners can refresh a limited number of times per period. Uploaded files cannot be refreshed. operationId: refreshTeamspaceLibrary security: - bearerAuth: [] requestBody: required: false content: application/json: schema: type: object properties: branch: type: string description: A branch version to refresh in place of the default branch. gitToken: type: string description: "Token for a private repository. Default: the account connected in the dashboard." pageIds: type: array maxItems: 5000 items: type: string description: "Confluence and Notion: the pages to index." responses: "200": description: The refresh started content: application/json: schema: type: object required: - message properties: message: type: string example: message: Refresh started successfully "400": description: The library cannot be refreshed (uploaded files) content: application/json: schema: $ref: "#/components/schemas/Error" example: error: refresh_not_supported message: Uploaded files cannot be refreshed. Re-upload the file to update it. "401": $ref: "#/components/responses/UnauthorizedError" "403": description: The caller cannot access this teamspace, the API key belongs to another teamspace, or the caller's role is too low content: application/json: schema: $ref: "#/components/schemas/Error" example: error: forbidden message: You do not have access to this teamspace. "404": description: The teamspace has no library with this id (neither claimed nor one of its private sources) content: application/json: schema: $ref: "#/components/schemas/Error" example: error: library_not_found message: This teamspace has no library with this id. "409": description: No token for the private repository, or the Confluence or Notion account is not connected in the dashboard content: application/json: schema: $ref: "#/components/schemas/Error" example: error: git_token_required message: A git access token is required to refresh a private repository. Please provide a gitToken in the request body or connect your Git account at https://context7.com/add-library "429": $ref: "#/components/responses/RateLimitError" "500": $ref: "#/components/responses/InternalServerError" components: securitySchemes: bearerAuth: type: http scheme: bearer description: Get your API key at [context7.com/dashboard](https://context7.com/dashboard). Treat your API key like a password and store it securely. schemas: Error: type: object description: Standard error response properties: error: type: string description: Error code identifier message: type: string description: Human-readable error message required: - error - message responses: InternalServerError: description: Internal Server Error content: application/json: schema: $ref: "#/components/schemas/Error" example: error: internal_error message: An error occurred while processing your request UnauthorizedError: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: "#/components/schemas/Error" example: error: invalid_api_key message: Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix. RateLimitError: description: Too Many Requests - Rate limit exceeded headers: Retry-After: description: Seconds until rate limit resets schema: type: integer RateLimit-Limit: description: Request limit schema: type: integer RateLimit-Remaining: description: Remaining requests schema: type: integer RateLimit-Reset: description: Unix timestamp when limit resets schema: type: integer content: application/json: schema: $ref: "#/components/schemas/Error" example: error: rate_limit_exceeded message: Rate limit exceeded. Please try again later. ````