Quizzes

Download schema

Páginas de quiz y registros de quiz.

Listar quizzes

GET

https://automation.atomicat-api.com/api/automation/v1

/quizzes

Los ids de quiz vienen del registro (qid) y no siempre coinciden con el id de la página.

Alcance requerido: pages:read.

Listar quizzes › query Parameters

limit

integer · min: 1 · max: 100

Cantidad máxima de registros. El valor predeterminado es 50 y el máximo es 100.

Default: 50

page

integer · min: 0

Índice de página que empieza en cero. La API devuelve limit registros a partir de page × limit.

Default: 0

query

string

Texto sin distinción de mayúsculas que se compara con el nombre y los campos relacionados.

page_id

string

Solo quizzes de esta página.

quiz_id

string

Id exacto del quiz.

Listar quizzes › Responses

Registros coincidentes. El cuerpo es un arreglo JSON.

Quiz[]

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Crear una página de quiz

POST

https://automation.atomicat-api.com/api/automation/v1

/quizzes

Alcance requerido: pages:write.

Crear una página de quiz › Request Body

QuizCreate

name

string · required

Nombre de la página de quiz.

project_id

string

Id del proyecto.

site_id

string

Id del sitio.

Crear una página de quiz › Responses

La página de quiz creada.

Una página de quiz recién creada. id es el id de la página. Los listados posteriores devuelven el qid, que puede ser distinto.

QuizPage

id

string

Id de la página.

quiz_id

string

Igual que id al crear.

is_quiz

boolean

Siempre true.

name

string

Nombre.

page_name

string

Nombre.

project_id

string | null

Id del proyecto.

site_id

string | null

Id del sitio.

edit_url

string

URL del constructor.

POST/quizzes

curl --request POST \
  --url https://automation.atomicat-api.com/api/automation/v1/quizzes \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "project_id": "project_id",
  "site_id": "site_id"
}
'

Example Request Body

{
  "name": "name",
  "project_id": "project_id",
  "site_id": "site_id"
}

json

Example Responses

{
  "id": "page_123",
  "name": "Main Offer",
  "page_name": "Main Offer",
  "status": "draft",
  "is_quiz": true,
  "project_id": "project_123",
  "site_id": null,
  "site_name": null,
  "domain": null,
  "slug": "",
  "url": null,
  "edit_url": "https://app.atomicat.com.br/builder/page_123",
  "created_at": "2026-09-26T12:00:00.000Z",
  "updated_at": "2026-09-26T12:00:00.000Z",
  "published_at": null,
  "quiz_id": "page_123"
}

json

application/json

Buscar quizzes

GET

https://automation.atomicat-api.com/api/automation/v1

/search/quizzes

Los mismos filtros y la misma respuesta que GET /quizzes.

Alcance requerido: pages:read.

Buscar quizzes › query Parameters

limit

integer · min: 1 · max: 100

Cantidad máxima de registros. El valor predeterminado es 50 y el máximo es 100.

Default: 50

page

integer · min: 0

Índice de página que empieza en cero. La API devuelve limit registros a partir de page × limit.

Default: 0

query

string

Texto sin distinción de mayúsculas que se compara con el nombre y los campos relacionados.

page_id

string

Id de la página.

quiz_id

string

Id del quiz.

Buscar quizzes › Responses

Registros coincidentes. El cuerpo es un arreglo JSON.

Quiz[]

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Obtener un quiz

GET

https://automation.atomicat-api.com/api/automation/v1

/quizzes/{quizId}

quizId puede ser el id del quiz (qid) o el id de una página marcada como quiz.

Alcance requerido: pages:read.

Obtener un quiz › path Parameters

quizId

string · required

Id del quiz o de la página quiz.

Obtener un quiz › Responses

El quiz.

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Crear un quiz desde una plantilla

POST

https://automation.atomicat-api.com/api/automation/v1

/quizzes/from-template

Alcance requerido: pages:write.

Crear un quiz desde una plantilla › Request Body

PageFromTemplate

template_id

string · required

Id de plantilla de GET /templates.

name

string

Nombre de la página nueva.

site_id

string

Sitio al que unirla, si aplica.

project_id

string

Id del proyecto.

Crear un quiz desde una plantilla › Responses

La página de quiz creada.

Una página de quiz recién creada. id es el id de la página. Los listados posteriores devuelven el qid, que puede ser distinto.

QuizPage

id

string

Id de la página.

quiz_id

string

Igual que id al crear.

is_quiz

boolean

Siempre true.

name

string

Nombre.

page_name

string

Nombre.

project_id

string | null

Id del proyecto.

site_id

string | null

Id del sitio.

edit_url

string

URL del constructor.

POST/quizzes/from-template

curl --request POST \
  --url https://automation.atomicat-api.com/api/automation/v1/quizzes/from-template \
  --header 'Content-Type: application/json' \
  --data '
{
  "template_id": "template_id",
  "name": "name",
  "site_id": "site_id",
  "project_id": "project_id"
}
'

Example Request Body

{
  "template_id": "template_id",
  "name": "name",
  "site_id": "site_id",
  "project_id": "project_id"
}

json

Example Responses

{
  "id": "page_123",
  "name": "Main Offer",
  "page_name": "Main Offer",
  "status": "draft",
  "is_quiz": true,
  "project_id": "project_123",
  "site_id": null,
  "site_name": null,
  "domain": null,
  "slug": "",
  "url": null,
  "edit_url": "https://app.atomicat.com.br/builder/page_123",
  "created_at": "2026-09-26T12:00:00.000Z",
  "updated_at": "2026-09-26T12:00:00.000Z",
  "published_at": null,
  "quiz_id": "page_123",
  "from_template": true,
  "template_id": "template_123"
}

json

application/json

Builder Funnels

Listar quizzes

GET

https://automation.atomicat-api.com/api/automation/v1

/quizzes

Los ids de quiz vienen del registro (qid) y no siempre coinciden con el id de la página.

Alcance requerido: pages:read.

Listar quizzes › query Parameters

limit

integer · min: 1 · max: 100

Cantidad máxima de registros. El valor predeterminado es 50 y el máximo es 100.

Default: 50

page

integer · min: 0

Índice de página que empieza en cero. La API devuelve limit registros a partir de page × limit.

Default: 0

query

string

Texto sin distinción de mayúsculas que se compara con el nombre y los campos relacionados.

page_id

string

Solo quizzes de esta página.

quiz_id

string

Id exacto del quiz.

Listar quizzes › Responses

Registros coincidentes. El cuerpo es un arreglo JSON.

Quiz[]

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Crear una página de quiz

POST

https://automation.atomicat-api.com/api/automation/v1

/quizzes

Alcance requerido: pages:write.

Crear una página de quiz › Request Body

QuizCreate

name

string · required

Nombre de la página de quiz.

project_id

string

Id del proyecto.

site_id

string

Id del sitio.

Crear una página de quiz › Responses

La página de quiz creada.

Una página de quiz recién creada. id es el id de la página. Los listados posteriores devuelven el qid, que puede ser distinto.

QuizPage

id

string

Id de la página.

quiz_id

string

Igual que id al crear.

is_quiz

boolean

Siempre true.

name

string

Nombre.

page_name

string

Nombre.

project_id

string | null

Id del proyecto.

site_id

string | null

Id del sitio.

edit_url

string

URL del constructor.

Buscar quizzes

GET

https://automation.atomicat-api.com/api/automation/v1

/search/quizzes

Los mismos filtros y la misma respuesta que GET /quizzes.

Alcance requerido: pages:read.

Buscar quizzes › query Parameters

limit

integer · min: 1 · max: 100

Cantidad máxima de registros. El valor predeterminado es 50 y el máximo es 100.

Default: 50

page

integer · min: 0

Índice de página que empieza en cero. La API devuelve limit registros a partir de page × limit.

Default: 0

query

string

Texto sin distinción de mayúsculas que se compara con el nombre y los campos relacionados.

page_id

string

Id de la página.

quiz_id

string

Id del quiz.

Buscar quizzes › Responses

Registros coincidentes. El cuerpo es un arreglo JSON.

Quiz[]

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Obtener un quiz

GET

https://automation.atomicat-api.com/api/automation/v1

/quizzes/{quizId}

quizId puede ser el id del quiz (qid) o el id de una página marcada como quiz.

Alcance requerido: pages:read.

Obtener un quiz › path Parameters

quizId

string · required

Id del quiz o de la página quiz.

Obtener un quiz › Responses

El quiz.

Quiz

id

string

Id del quiz (qid).

name

string

Nombre visible, con el nombre de la página si se conoce.

quiz_name

string

Nombre del quiz.

page_id

string | null

Página que hospeda el quiz.

page_name

string | null

Nombre de la página.

site_id

string | null

Id del sitio.

project_id

string | null

Id del proyecto.

created_at

string | null

Marca de tiempo ISO-8601.

updated_at

string | null

Marca de tiempo ISO-8601.

Crear un quiz desde una plantilla

POST

https://automation.atomicat-api.com/api/automation/v1

/quizzes/from-template

Alcance requerido: pages:write.

Crear un quiz desde una plantilla › Request Body

PageFromTemplate

template_id

string · required

Id de plantilla de GET /templates.

name

string

Nombre de la página nueva.

site_id

string

Sitio al que unirla, si aplica.

project_id

string

Id del proyecto.

Crear un quiz desde una plantilla › Responses

La página de quiz creada.

Una página de quiz recién creada. id es el id de la página. Los listados posteriores devuelven el qid, que puede ser distinto.

QuizPage

id

string

Id de la página.

quiz_id

string

Igual que id al crear.

is_quiz

boolean

Siempre true.

name

string

Nombre.

page_name

string

Nombre.

project_id

string | null

Id del proyecto.

site_id

string | null

Id del sitio.

edit_url

string

URL del constructor.