Restaurar versão

POST

/connectors/{connectorId}/versions/{seq}/restore

curl --request POST \
  --url https://api-connect.zoppy.com.br/connectors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/versions/1/restore \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "baseSeq": 1 }'

• Produção
• Staging

Escreve uma versão nova com o código e o manifesto de seq. Recusa se outra versão entrou depois de baseSeq.

Authorizations

• bearer

Parameters

Path Parameters

connectorId

required

Id do conector

string format: uuid

Id do conector

seq

required

Número da versão

integer

>= 1

Número da versão

Request Body^required

Media typeapplication/json

object

baseSeq

required

HeadSeq que a pessoa viu; uma versão mais nova recusa com connect.version_conflict

integer

Example ^generated

{
  "baseSeq": 1
}

Responses

201

Versão nova

Media typeapplication/json

object

seq

required

Número da versão

integer

origin

required

Copilot (escrita pela IA), restore ou cli (enviada pela CLI zoppy-connect)

string

Allowed values: copilot restore cli

summary

required

O que mudou, em português

string

nullable

authorUserId

required

Quem escreveu ou restaurou

string

restoredFromSeq

required

Versão que ela restaurou

integer

nullable

rehearsedAt

required

Instante em ISO 8601

string format: date-time

nullable

needsFullRehearsal

required

Uma amostra limpa foi cortada e nenhum ensaio completo passou desde então: ensaie com scope full

boolean

writesWithoutLookup

required

Criações sem consulta anterior vistas no último ensaio desta versão (connect.write_without_lookup); enquanto a lista não estiver vazia, rehearsedAt fica null e publicar responde 409. Um ensaio limpo esvazia a lista

Array<object>

object

method

required

Método HTTP da criação

string

host

required

Host chamado

string

path

required

Caminho chamado, sem query

string

count

required

Quantas vezes o ensaio fez essa chamada

integer

published

required

Se esta é a versão que roda de verdade

boolean

createdAt

required

Quando foi escrita

string format: date-time

Example

{
  "origin": "copilot"
}

400

Entrada inválida (validation_failed)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

401

Token ausente, inválido ou expirado (connect.unauthorized)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

403

Papel sem acesso ou Connect não liberado (connect.forbidden_role, connect.feature_disabled)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

404

Conector ou versão inexistente (connect.version_not_found)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}

409

Outra versão entrou antes (connect.version_conflict)

Media typeapplication/json

object

type

required

Código estável do erro, para máquinas (ex.: connect.connector_not_found)

string

title

required

Nome da classe do erro

string

status

required

Status HTTP

integer

detail

required

Mensagem em pt-BR, segura para mostrar a quem usa a tela

string

requestId

required

Id de correlação: passe ao suporte para achar o rastro completo

string

nullable

meta

Detalhes estruturados seguros para a tela (erros de campo, ids)

object

key

additional properties

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "requestId": "example",
  "meta": {
    "additionalProperty": "example"
  }
}