Ir al contenido

Editor de fuente

Los artifacts no-HTML tienen un editor de fuente en el browser en /a/{slug}/edit. Comparte el mismo patrón de URL y las mismas reglas de acceso que el estudio visual, pero se abre en lugar de él cuando el tipo de artifact es markdown, txt, json o csv.

URLPropósitoAcceso
/a/{slug}/editEditor de fuenteOwner y colaboradores con rol editor (sesión requerida)
/a/{slug}/Viewer en vivoSegún visibilidad del artifact

Las requests no autenticadas redirigen al login de Google con redirect=/a/{slug}/edit.

TipoEntry point por defectoMIME
markdownindex.mdtext/markdown
txtindex.txttext/plain
jsonindex.jsonapplication/json
csvindex.csvtext/csv

Los artifacts HTML abren el estudio visual en cambio. Enviar el slug de un artifact HTML a /edit abre el estudio visual, no este editor.

POST /a/{slug}/edit/source/publish
Content-Type: application/json
Cookie: shareout_session=…
{ "content": "# Doc actualizado\n\nNuevo contenido acá." }

Respuesta (200):

{
"success": true,
"versionNo": 3,
"url": "https://shareout.site/a/my-doc/"
}

Cada publicación crea una nueva versión del artifact, actualiza el metadata del tipo (conteos de filas, tabla de contenidos, etc.) e invalida los caches de deployment.

Errores:

CódigoStatusCausa
INVALID_REQUEST400Falta el campo content
UNSUPPORTED400El tipo de artifact no es editable como fuente (p. ej. html)
ARTIFACT_NOT_FOUND404El slug no resuelve

Los agentes deben usar POST /v1/publish para crear o actualizar artifacts de texto programáticamente — no el endpoint del editor de fuente. El editor de fuente es para owners humanos que editan en el browser.

Para actualizar un artifact de texto existente via la API, re-publicá con el mismo slug en el mismo workspace. El dedup coincide por display_slug y versiona en su lugar.