> ## Documentation Index > Fetch the complete documentation index at: https://developers.parkes.ai/llms.txt > Use this file to discover all available pages before exploring further. # Refresh item > Requires marketplace:write and applicable Marketplace permissions. Required scopes (OAuth and personal tokens): marketplace:write. Resource permissions also apply. ## OpenAPI ````yaml /marketplace-openapi.json post /marketplace/v1/releases/{release_id}/items/{id}/refresh openapi: 3.0.3 info: title: Parkes Marketplace API version: 1.0.0 description: > Manage publisher listings, draft releases, items, artwork, and publication. Uses the same organization-scoped bearer credentials as the REST API. Customer browsing and installations remain under /rest/v1/marketplace. ## Authentication and organization access Send an OAuth access token or personal token as `Authorization: Bearer `. Each credential belongs to exactly one organization. Authorize additional organizations separately; resource routes do not take an organization selection header or path parameter. Required scopes and current member permissions both apply. Use `GET /rest/v1/me` to inspect the authenticated identity. ## Pagination Collections return `data` and `page.next_cursor`. A null cursor means the traversal is complete. Pass the cursor with the same filters to retrieve the next page. Most collections default to 50 records and allow up to 200; Knowledge search has its own limit. Activity tail cursors represent a continuing feed rather than a completed traversal. ## Mutations and concurrency Send JSON for operations with a request body. Unknown fields are rejected; omitted update fields stay unchanged and null is accepted only where declared nullable. Every POST requires an `Idempotency-Key` of at most 128 bytes. Reuse the same key and body when retrying the same logical mutation. Other mutations accept an optional key. Conditional mutations require `If-Match` with the resource's latest ETag. For nested automation triggers and Marketplace items, use the parent automation or release ETag returned by the read operation. Knowledge content writes additionally require `expected_version` from the document's version field. A 202 response confirms admission, not completion; follow the returned operation or run. ## Errors and limits Handled API errors use `application/problem+json`. Inspect `code` for the error category, `detail` for context, and `request_id` when reporting a failure. Validation errors may include an `errors` object keyed by field. Each operation lists its expected errors. Unexpected server or infrastructure errors may have a different body; clients must tolerate other HTTP error responses. The request body limit is 2 MiB unless an operation specifies otherwise. The limit applies even to a body sent with a read request. Request budgets are shared per member and organization; a 429 response includes `Retry-After` in seconds. A temporarily unavailable API contract can also return 503 on any operation. servers: - url: https://api.parkes.ai security: - bearer: [] tags: - name: Listings description: >- Manage your publisher listings, inspect analytics, and control visibility. Listing creation creates an initial draft release. Existing publisher ownership and organization permissions apply. - name: Releases description: >- Create and edit draft releases, validate their contents, and publish. Read a release to obtain its current ETag before changing it. Published releases remain immutable. - name: Release items description: >- Add source content to a draft release and manage its snapshots, ordering, schedules, and trigger inputs. Conditional writes use the parent release ETag. - name: Artwork description: >- Upload or remove draft release cover and thumbnail images. Send base64-encoded image content and the parent release ETag. - name: Publishing sources description: >- Find organization content you are allowed to include in a marketplace release. Publishing access and the marketplace:write scope are required. paths: /marketplace/v1/releases/{release_id}/items/{id}/refresh: post: tags: - Release items summary: Refresh item description: >- Requires marketplace:write and applicable Marketplace permissions. Required scopes (OAuth and personal tokens): marketplace:write. Resource permissions also apply. operationId: refreshMarketplaceItem parameters: - name: release_id in: path required: true schema: type: string description: Identifier of the requested resource. - name: id in: path required: true schema: type: string description: Identifier of the requested resource. - name: If-Match in: header required: true schema: type: string description: >- Current ETag of the resource being changed. Fetch it before submitting this mutation. - name: Idempotency-Key in: header required: true schema: type: string description: >- A unique key for this logical mutation (at most 128 bytes). Reuse it only when retrying the same request. Required for POST; optional for other mutations. responses: '200': description: Request completed successfully. content: application/json: schema: $ref: '#/components/schemas/RefreshMarketplaceItemResponse' headers: ETag: $ref: '#/components/headers/ETag' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '412': $ref: '#/components/responses/PreconditionFailed' '413': $ref: '#/components/responses/ContentTooLarge' '422': $ref: '#/components/responses/UnprocessableContent' '428': $ref: '#/components/responses/PreconditionRequired' '429': $ref: '#/components/responses/TooManyRequests' security: - oauth: - marketplace:write - bearer: [] components: schemas: RefreshMarketplaceItemResponse: type: object properties: data: $ref: '#/components/schemas/MarketplaceRelease' required: - data MarketplaceRelease: type: object properties: name: type: string summary: type: string description: type: string headline: type: string nullable: true category_id: type: string nullable: true release_notes: type: string example_prompts: type: array items: type: string maxItems: 50 integration_slugs: type: array items: type: string maxItems: 20 id: type: string listing_id: type: string status: type: string enum: - draft - published version: type: integer nullable: true updated_at: type: string required: - id - listing_id - status - name - summary - updated_at Problem: type: object properties: type: type: string title: type: string status: type: integer code: type: string detail: type: string request_id: type: string description: Request identifier to include when reporting an API failure. errors: type: object additionalProperties: type: array items: type: string required: - type - title - status - code - detail description: >- A handled API failure. The HTTP status and status field agree; code identifies the failure category. headers: ETag: description: >- Opaque resource version. Send this value unchanged as If-Match on conditional mutations. schema: type: string responses: BadRequest: description: Invalid request parameters, body, or idempotency key. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Unauthorized: description: Missing, expired, revoked, or invalid bearer credential. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: about:blank title: Unauthenticated status: 401 code: unauthenticated detail: A valid bearer credential is required request_id: 0b7238c5-a883-4ed0-8613-31f531e50f40 headers: WWW-Authenticate: description: Bearer authentication challenge. schema: type: string example: Bearer Forbidden: description: Insufficient scope or resource permissions. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' NotFound: description: Resource not found or not visible to this credential. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Conflict: description: Resource state or idempotency conflict. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' PreconditionFailed: description: Resource or content version has changed. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' ContentTooLarge: description: Request body exceeds the operation limit. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' UnprocessableContent: description: Request failed domain validation. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' PreconditionRequired: description: Required If-Match header is missing. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: type: about:blank title: Precondition required status: 428 code: precondition_required detail: Supply the resource ETag in If-Match request_id: 0b7238c5-a883-4ed0-8613-31f531e50f40 TooManyRequests: description: Rate limit exceeded; wait Retry-After seconds. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' headers: Retry-After: description: Delay in seconds before retrying. schema: type: integer example: 60 securitySchemes: bearer: type: http scheme: bearer oauth: type: oauth2 flows: authorizationCode: authorizationUrl: /oauth/authorize tokenUrl: /oauth/token refreshUrl: /oauth/token scopes: organizations:read: Organizations read integrations:read: Integrations read integrations:write: Integrations write connections:read: Connections read connections:write: Connections write skills:read: Skills read skills:write: Skills write skills:execute: Skills execute automations:read: Automations read automations:write: Automations write automations:execute: Automations execute knowledge:read: Knowledge read knowledge:write: Knowledge write marketplace:read: Marketplace read marketplace:write: Marketplace write marketplace:publish: Marketplace publish users:read: Users read users:manage: Users manage activity:read: Activity read activity:write: Activity write models:read: Models read library:read: Read Library files and folders library:write: Delete Library files and create share links agent:execute: >- Execute and observe agent conversations; browser OAuth may resolve interactions community:read: Read Community spaces and discussions community:write: Join spaces, comment, and react notifications:write: >- Register this device for push notifications about the user's agent runs; granted only to the first-party iOS app ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.