Tessell

Tessell Service Refresh Controller API

The service-refresh-controller API from Tessell — 4 operation(s) for service-refresh-controller.

GitHub OpenAPI

Operations 6

PATCH /services/{id}/refresh Refresh service with parent service's snapshot or pitr #
GET /services/{id}/schedules/refresh Fetch all the refresh schedules for a service #
POST /services/{id}/schedules/refresh Create refresh schedule for a service #
PATCH /services/{service-id}/schedules/refresh/{id} Update the refresh schedule #
DELETE /services/{service-id}/schedules/refresh/{id} Delete the refresh schedule #
PATCH /services/{service-id}/schedules/refresh/{id}/{action} Update the refresh schedule status #

Documentation

📖
Documentation
https://docs.tessell.com/tessell
📖
APIReference
https://developer.tessell.com/reference
📖
GettingStarted
https://developer.tessell.com/docs/getting-started

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tessell/openapi/tessell-service-refresh-controller-api-openapi.yml

Other Resources

🔗
Webhooks
https://artifacts.apis.io/tessell/asyncapi/tessell-notifications-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tessell:tessell-service-refresh-controller-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tessell-service-refresh-controller-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tessell Service Refresh Controller API
  contact:
    email: support@tessell.com
    name: Tessell Inc
    url: https://www.tessell.com
  description: Tessell API Documentation
  termsOfService: https://www.tessell.com/terms
  version: '1.0'
servers:
- url: '{server}'
  variables:
    server:
      default: console.tessell.com
tags:
- name: service-refresh-controller
paths:
  /services/{id}/refresh:
    patch:
      tags:
      - service-refresh-controller
      summary: Refresh service with parent service's snapshot or pitr
      operationId: refreshService
      parameters:
      - $ref: '#/components/parameters/id'
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefreshServicePayload'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/taskSummary'
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
  /services/{id}/schedules/refresh:
    get:
      tags:
      - service-refresh-controller
      summary: Fetch all the refresh schedules for a service
      operationId: getRefreshSchedules
      parameters:
      - $ref: '#/components/parameters/id'
      - name: status
        description: Refresh Schedule Status
        in: query
        style: form
        required: false
        schema:
          type: array
          items:
            $ref: '#/components/schemas/RefreshScheduleStatus'
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRefreshSchedulesResponse'
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
    post:
      tags:
      - service-refresh-controller
      summary: Create refresh schedule for a service
      operationId: createRefreshSchedule
      parameters:
      - $ref: '#/components/parameters/id'
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUpdateRefreshSchedulePayload'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshScheduleDTO'
        '201':
          description: Created
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
  /services/{service-id}/schedules/refresh/{id}:
    patch:
      tags:
      - service-refresh-controller
      summary: Update the refresh schedule
      operationId: updateRefreshSchedule
      parameters:
      - $ref: '#/components/parameters/service-id'
      - $ref: '#/components/parameters/id'
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateUpdateRefreshSchedulePayload'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshScheduleDTO'
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
    delete:
      tags:
      - service-refresh-controller
      summary: Delete the refresh schedule
      operationId: deleteRefreshSchedule
      parameters:
      - $ref: '#/components/parameters/service-id'
      - $ref: '#/components/parameters/id'
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiStatus'
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
  /services/{service-id}/schedules/refresh/{id}/{action}:
    patch:
      tags:
      - service-refresh-controller
      summary: Update the refresh schedule status
      operationId: updateRefreshScheduleStatus
      parameters:
      - $ref: '#/components/parameters/service-id'
      - $ref: '#/components/parameters/id'
      - name: action
        in: path
        description: Update schedule status to RESUME or PAUSE.
        required: true
        style: simple
        schema:
          type: string
      - name: Authorization
        in: header
        description: Authorization Token
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiStatus'
        default:
          description: API error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    BackupType:
      description: Backup Content Type
      type: string
      enum:
      - AS_IS
      - SANITIZED
    ApiError:
      type: object
      description: Common error response object for non 2xx responses
      properties:
        code:
          type: string
          description: Status code for the error response
        message:
          type: string
          description: Error message for API response
        resolution:
          type: string
        timestamp:
          type: string
          format: date-time
        contextId:
          type: string
          description: ContextId of API request
        sessionId:
          type: string
          description: SessionId of API request
        tessellErrorCode:
          type: string
          description: Unique error code specific to Tessell
    GetRefreshSchedulesResponse:
      allOf:
      - $ref: '#/components/schemas/apiResponse'
      - type: object
        properties:
          response:
            type: array
            items:
              $ref: '#/components/schemas/RefreshScheduleDTO'
    RefreshServicePayload:
      properties:
        pitr:
          type: string
          description: Refresh till the parent availability machine pitr timestamp
        snapshotId:
          type: string
          description: Parent Availability Machine snapshot id for the refresh
          format: uuid
        scriptInfo:
          $ref: '#/components/schemas/PrePostScriptInfo'
        ignorePreScriptFailure:
          type: boolean
          default: false
          description: If true, continue refresh even if pre-script fails.
        ignorePostScriptFailure:
          type: boolean
          default: true
          description: If true, continue refresh even if post-script fails.
        sourceType:
          $ref: '#/components/schemas/CloneSourceType'
          description: Source type for refresh operation (defaults to SNAPSHOT)
    RefreshScheduleStatus:
      enum:
      - ACTIVE
      - PAUSED
      - SUSPENDED
    RefreshScheduleRefreshMode:
      enum:
      - SNAPSHOT
      - PITR
    apiStatus:
      title: apiStatus
      type: object
      properties:
        status:
          type: string
        message:
          type: string
    PrePostScriptInfo:
      type: object
      properties:
        preScriptInfo:
          type: array
          items:
            $ref: '#/components/schemas/ScriptInfo'
        postScriptInfo:
          type: array
          items:
            $ref: '#/components/schemas/ScriptInfo'
    TimeFormat:
      title: TimeFormat
      description: Clock time format value in hour and minute.
      type: object
      required:
      - hour
      - minute
      properties:
        hour:
          type: integer
          format: int32
          minimum: 0
          maximum: 23
          default: 1
        minute:
          type: integer
          format: int32
          minimum: 0
          maximum: 59
          default: 0
    RefreshScheduleMetadata:
      type: object
      properties:
        scriptInfo:
          $ref: '#/components/schemas/PrePostScriptInfo'
        lastWorkflowDispatchTime:
          description: Time at which refresh workflow is dispatched using schedule refresh.
          type: string
          format: date-time
    taskSummary:
      title: taskSummary
      type: object
      properties:
        taskId:
          type: string
          format: uuid
        taskType:
          type: string
        resourceId:
          type: string
          format: uuid
        associatedResourceIds:
          type: array
          items:
            type: string
            format: uuid
        details:
          type: object
          additionalProperties:
            type: string
    CloneSourceType:
      description: Source type for clone/refresh operation
      type: string
      enum:
      - SNAPSHOT
      - NATIVE_BACKUP
    apiMetadata:
      title: apiMetadata
      type: object
      properties:
        timeZone:
          type: string
        records:
          type: integer
          format: int32
        pagination:
          $ref: '#/components/schemas/apiPaginationInfo'
    RefreshScheduleRecurrenceInfo:
      type: object
      required:
      - triggerTime
      properties:
        triggerTime:
          $ref: '#/components/schemas/TimeFormat'
        dailySchedule:
          type: object
          properties:
            enabled:
              type: boolean
        weeklySchedule:
          type: object
          properties:
            weekDays:
              type: array
              uniqueItems: true
              items:
                $ref: '#/components/schemas/WeekDay'
    apiPaginationInfo:
      title: apiPaginationInfo
      type: object
      properties:
        pageSize:
          type: integer
          format: int32
        pageOffset:
          type: integer
          format: int32
    ScriptInfo:
      title: ScriptInfo
      type:
      - object
      - 'null'
      properties:
        scriptId:
          type: string
          format: uuid
          description: The Tessell Script ID
        scriptName:
          type: string
          description: The Tessell Script Name
        scriptVersion:
          type: string
          description: The Tessell Script version
        useActiveVersion:
          type: boolean
          default: false
          description: 'When set to true, the scriptVersion field should be null and the system

            will automatically use the active version of the script.

            When set to false (default), the scriptVersion field specifies the

            exact version to use.

            '
    CreateUpdateRefreshSchedulePayload:
      properties:
        refreshMode:
          $ref: '#/components/schemas/RefreshScheduleRefreshMode'
        contentType:
          $ref: '#/components/schemas/BackupType'
        scriptInfo:
          $ref: '#/components/schemas/PrePostScriptInfo'
        scheduleInfo:
          $ref: '#/components/schemas/RefreshScheduleInfo'
    RefreshScheduleDTO:
      properties:
        id:
          type: string
          format: uuid
        serviceId:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        status:
          $ref: '#/components/schemas/RefreshScheduleStatus'
        metadata:
          $ref: '#/components/schemas/RefreshScheduleMetadata'
        scheduleInfo:
          $ref: '#/components/schemas/RefreshScheduleInfo'
        contentType:
          $ref: '#/components/schemas/BackupType'
        refreshMode:
          $ref: '#/components/schemas/RefreshScheduleRefreshMode'
        owner:
          type: string
        dateCreated:
          type: string
          format: date-time
        dateModified:
          type: string
          format: date-time
    WeekDay:
      description: Week Days
      type: string
      enum:
      - Sunday
      - Monday
      - Tuesday
      - Wednesday
      - Thursday
      - Friday
      - Saturday
      x-enum-varnames:
      - Sunday
      - Monday
      - Tuesday
      - Wednesday
      - Thursday
      - Friday
      - Saturday
    apiResponse:
      example:
        metadata:
          pagination:
            pageOffset: 0
            pageSize: 6
          records: 1
          timeZone: timeZone
        response: '{}'
      properties:
        metadata:
          $ref: '#/components/schemas/apiMetadata'
        response:
          type: object
      title: ApiResponse
      type: object
    RefreshScheduleInfo:
      type: object
      properties:
        recurring:
          $ref: '#/components/schemas/RefreshScheduleRecurrenceInfo'
  parameters:
    service-id:
      name: service-id
      in: path
      required: true
      style: simple
      schema:
        type: string
        format: uuid
    id:
      name: id
      description: Id of entity
      in: path
      style: simple
      required: true
      schema:
        type: string
        format: uuid
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
x-provenance:
  method: harvested
  publisher: Tessell
  source: https://developer.tessell.com/openapi/tessell-apis.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)