> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a connector action refresh > Creates an action refresh for one of the project's own remote MCP connectors: lists the tools the connector's server offers today, through every active linked account the caller may run actions with, and merges them into the latest version of the connector: tools the server added become actions, actions whose tool changed are rewritten, and actions whose tool the server no longer offers are removed. An account is only ever asked through the server it was linked to, so one whose connector version names another server is skipped. Removals are skipped when any account was skipped or could not reach the server. A connector that had no actions yet keeps its version; any other change is registered as a new version, which becomes the latest. Answers 403 when the caller has no such account, and 502 when no account could reach the server. ## OpenAPI ````yaml post /v2/connectors/{id}/action_refreshes openapi: 3.1.0 info: title: StackOne description: The documentation for the StackOne API version: 1.0.0 contact: {} servers: - url: https://api.stackone.com security: [] tags: - name: Accounts description: View and manage linked accounts. - name: Connector Profiles description: >- View and manage connector profiles for the project: the authentication, enabled actions, data sync and events of each configured connector. - name: Connectors description: Retrieve metadata for connectors. - name: Webhooks description: Configure and manage webhooks. - name: Data Sync description: View data-sync configs, schedules, runs, and event subscriptions. paths: /v2/connectors/{id}/action_refreshes: post: tags: - Connectors summary: Create a connector action refresh description: >- Creates an action refresh for one of the project's own remote MCP connectors: lists the tools the connector's server offers today, through every active linked account the caller may run actions with, and merges them into the latest version of the connector: tools the server added become actions, actions whose tool changed are rewritten, and actions whose tool the server no longer offers are removed. An account is only ever asked through the server it was linked to, so one whose connector version names another server is skipped. Removals are skipped when any account was skipped or could not reach the server. A connector that had no actions yet keeps its version; any other change is registered as a new version, which becomes the latest. Answers 403 when the caller has no such account, and 502 when no account could reach the server. operationId: create_connector_action_refresh parameters: - name: id required: true in: path description: >- The connector key alone (e.g. `acme_tools`), without a version or owner. schema: type: string responses: '201': description: The action refresh was created. content: application/json: schema: $ref: '#/components/schemas/ConnectorActionRefreshResource' '400': description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/BadRequestResponse' '401': description: Unauthorized access. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedResponse' '403': description: Forbidden. content: application/json: schema: $ref: '#/components/schemas/ForbiddenResponse' '404': description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/NotFoundResponse' '408': description: The request has timed out. headers: Retry-After: description: A time in seconds after which the request can be retried. schema: type: string content: application/json: schema: $ref: '#/components/schemas/RequestTimedOutResponse' '409': description: Conflict with current state. content: application/json: schema: $ref: '#/components/schemas/ConflictResponse' '422': description: Validation error. content: application/json: schema: $ref: '#/components/schemas/UnprocessableEntityResponse' '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsResponse' '500': description: Server error while executing the request. content: application/json: schema: $ref: '#/components/schemas/InternalServerErrorResponse' '501': description: This functionality is not implemented. content: application/json: schema: $ref: '#/components/schemas/NotImplementedResponse' '502': description: Bad gateway error. content: application/json: schema: $ref: '#/components/schemas/BadGatewayResponse' security: - basic: [] components: schemas: ConnectorActionRefreshResource: type: object properties: outcome: description: >- What the refresh did: `unchanged` when no changes were made to the connector, `updated` when actions were added to a connector that had none yet (its version is kept), `new_version` when the changes were registered as a new version, which becomes the latest. x-speakeasy-unknown-values: allow allOf: - $ref: '#/components/schemas/ConnectorActionRefreshOutcome' connector_key: type: string description: The key of the refreshed connector. version: type: string description: The version of the connector after the refresh. previous_version: type: string description: The latest version of the connector before the refresh. added: type: number description: The number of actions added for tools the server now offers. updated: type: number description: >- The number of actions rewritten because their tool changed on the server. removed: type: number description: >- The number of actions removed because the server no longer offers their tool. Always 0 when any account could not be reached. total: type: number description: The number of actions the connector has after the refresh. unreachable_accounts: type: number description: >- The number of linked accounts through which the MCP server could not be reached, including accounts linked to a different server than the latest version names. required: - outcome - connector_key - version - previous_version - added - updated - removed - total - unreachable_accounts BadRequestResponse: type: object properties: statusCode: type: number description: HTTP status code example: 400 message: type: string description: Error message example: Bad Request timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time data: description: Error details nullable: true type: object allOf: - $ref: '#/components/schemas/UnifiedError' provider_errors: description: List of provider-specific errors nullable: true type: array items: $ref: '#/components/schemas/ProviderError' required: - statusCode - message - timestamp UnauthorizedResponse: type: object properties: statusCode: type: number description: HTTP status code example: 401 message: type: string description: Error message example: Unauthorized timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp ForbiddenResponse: type: object properties: statusCode: type: number description: HTTP status code example: 403 message: type: string description: Error message example: Forbidden resource timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp NotFoundResponse: type: object properties: statusCode: type: number description: HTTP status code example: 404 message: type: string description: Error message example: Not Found timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp RequestTimedOutResponse: type: object properties: statusCode: type: number description: HTTP status code example: 408 message: type: string description: Error message example: Request timed out timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp ConflictResponse: type: object properties: statusCode: type: number description: HTTP status code example: 409 message: type: string description: Error message example: Conflict timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp UnprocessableEntityResponse: type: object properties: statusCode: type: number description: HTTP status code example: 422 message: type: string description: Error message example: Unprocessable Entity timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp TooManyRequestsResponse: type: object properties: statusCode: type: number description: HTTP status code example: 429 message: type: string description: Error message example: Too many requests timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp InternalServerErrorResponse: type: object properties: statusCode: type: number description: HTTP status code example: 500 message: type: string description: Error message example: Internal server error timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp NotImplementedResponse: type: object properties: statusCode: type: number description: HTTP status code example: 501 message: type: string description: Error message example: Not Implemented timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp BadGatewayResponse: type: object properties: statusCode: type: number description: HTTP status code example: 502 message: type: string description: Error message example: Bad Gateway timestamp: type: string description: Timestamp when the error occurred example: '2023-05-30T00:00:00.000Z' format: date-time required: - statusCode - message - timestamp ConnectorActionRefreshOutcome: type: string enum: - unchanged - updated - new_version description: >- What the refresh did: `unchanged` when no changes were made to the connector, `updated` when actions were added to a connector that had none yet (its version is kept), `new_version` when the changes were registered as a new version, which becomes the latest. UnifiedError: type: object properties: statusCode: type: number description: HTTP status code example: 400 nullable: true message: type: string description: Error message example: Bad Request nullable: true headers: type: object description: Response headers example: content-type: application/json x-request-id: 5678c28b211dace4e0a0f9171e6b88c5 nullable: true ProviderError: type: object properties: status: type: number description: HTTP status code of the provider error example: 400 nullable: true url: type: string description: URL that caused the error example: https://api.provider.com/v1/resource nullable: true raw: type: object description: Raw error response from the provider example: message: Invalid input parameters nullable: true headers: type: object description: Response headers example: content-type: application/json x-request-id: 5678c28b211dace4e0a0f9171e6b88c5 nullable: true securitySchemes: basic: type: http scheme: basic ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.